animation and its child timelines. 



UsesBaseValue 



Timeline 



UlContext 



StatusOfNextUse 



Speed 



Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransfonn applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnlmationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Rectangle 
RectangleTop="20" 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Red" 
StrokeThlckness="5"> 

<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100.100" ViewPortUnits="Absolute" 
lmageSource="help.gif' TileMode="Tile"/> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!- Animate the Rectangle's width: ~> 
<LengthAnimationCollection> 
<LengthAnimation 

To="600" Duration="10" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle. RectangleWidth> 

</Rectangle> 
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When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransfonn object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator AffectsLayout="False"> 
<Transfomi Decorator.Transfomri> 

<!-- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX="1" ScaleY="1"> 
<ScaleTransfonn.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Duration="10" /> 
</ScaleTransfomri.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.Fill> 

<lmageBrush ViewPort="0.0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gir TileMode="Tile"/> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example— you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
Its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 



Fl atAnimati n Class 

Definition: Used to animate properties that accept a Single value. 
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Method Descripti n 

Beginln restarts the animation at the specified offset from the current 

time. Inherited from FloatTimedModifier. 
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CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Disable 



Implementation of CloneCore. 

Retums an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this FloatTimedModifier Inherited from 

FloatTimedModifier. 

Creates a copy of this FloatModifier Inherited from FloatModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its Statu sOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from FloatTimedModifier. 

Accesses the specified Changeable data member, processes it, and 
retums a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. 
This method throws an exception if the ParentTimeline property is 
null. Inherited from FloatTimedModifier. 

Schedules an interactive end time. Inherited from FloatTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from FloatTimedModifier. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Creates a new FloatAnimation with all properties set to their default 
values. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the value of the animation at the current time. 
Inherited from FloatModifier. 



EmbeddedChangeableWriter 

Enable 

Endin 
Equals 
FilllnClone 

Finalize 
FloatAnimation 



GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerifChangeable 

OnChanged 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the cun-ent object is modified. Classes that derive from 
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opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a FloatModifier Inherited 
from FloatModifier. 

Pauses this timeline. Inherited from FloatTlmedModifier. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from FloatTimedModlfier. 

Moves the current position of the animation backwards or fonvards from 

either the current time, the Begin time, or the End time. Inherited from 

FloatTimedModlfier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. Inherited from FloatTlmedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
AutoReverse reverse after it completes its forward iteration. Inherited from 

FloatTlmedModifier. 



Begin 

By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 



Gets or sets an offset to the start time of the animation. Inherited 
from FloatTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from FloatTimedModifier. 

Gets the current time value of the animation. Inherited from 
FloatTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited firom 
FloatTimedModifier. 
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Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 

IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 



Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from FloatTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
FloatTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
FloatTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from FloatTimedModifier. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from FloatTimedModifier 

Gets or sets the starting value of an animation. 

Gets or sets a value that specifies how output values are calculated 
for the animation. 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from FloatTimedModifier. 

IsCumulative 

Inherited from FloatTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from FloatTimedModifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from FloatTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from FloatTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
FloatTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from FloatTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from FloatTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from FloatTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself until the time specified by this property. Inherited from 
FloatTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from FloatTimedModifier 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from FloatTimedModifier 
Gets or sets the relative speed at which time should pass for the 
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animation, compared to its parent timeline. Inherited from 
FloatTimedModifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from FloatTimedModifier 
Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button*s Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 



StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseValue 
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Height="30" Width="200"> 



<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration^"?" 
RepeatCount="500" AutoReverse="True'V> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time. Indefinite or set its RepeatCount property to 
double. Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
Length Animation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="30" To="300" Duration="10" 

RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

//C# 

Line myline = new Llne(); 

LengthAnimation myLengthAnimation = new LengthAnimation(): 
myLength Animation. From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation. Duration = new Time( 10000); 
myLengthAnimation. RepeatDuration = Time.lndefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
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collection.Add(myLengthAnimation); 



myLine.SetAnimations(Line.X2Property. collection); 
' VB .NET 

Dim my Line As new MSAvalon.Wlndows. Shapes. Line 

Dim myLengthAnimation As new MSAvalon. Windows. Media. Animation.LengthAnimation 
myLengthAnimation.From = new MSAvalon. Windows. Length(30) 
myLengthAnimation.To = new MSAvalon. Windows. Length(300) 
myLengthAnimation. Duration = new MSAvalon.Windows. Media. Animation.Time(1 0000) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon. Windows.Media. Animation. LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property, collection) 



FloatAnimationCollection Class 

Definition: Represents a collection of FloatModifier animations. 

Method Description 

The Add(FloatModifier) and Add(Object) methods add animations to the 
Add collection. The Add(Single, FloatAnimationCollection) method calculates 

the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this 
AnimationCollection from Markup, 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified FloatModifier. 

Returns a modifiable copy of the current object The cop/s 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this FloatAnimationCollection. 
Copies the entire FloatAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 



AddChild 

AddText 

Apply 

Clear 
CloneCore 



CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 
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EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

FloatAnimationCollection 

GetEnumerator 

GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeabie 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op__Addition 
opjmpiiclt 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTlmeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 



Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Inherited from AnimationCollectlon. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perfonn other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Initializes a new instance of the FloatAnimationCollection class. 

GetEnumerator Inherited from AnimationCollectlon. 

Returns an object that can be used to enumerate items In the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates and returns the output of the animation collection. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
Instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
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WritePreamble 



OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOverride 

AnimationType 

CanMakeUnchangeable 

Count 

CountlmpI 

Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets the type of animation stored in the collection. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Inherited from AnimationCollection. 

An unchangeable empty FloatAnlmationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 

Gets or sets the animation at the specified index. 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as FloatAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of a FloatAnimationCollection, the property 
calls the FloatAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 
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This example demonstrates how to animate a property using Tonghorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True'7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From-'Red" To- 'Blue" Duration='7" 
RepeatCount="500" AutoReverse='True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 
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In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property — properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more infomnation about animating properties, see Animation in "Avalon". 



FloatKeyFrameCollection Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Add Strongly typed implementation of Add. 

CloneCore Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable, 

Creates a new FloatKeyFrameCollection 

Returns a modifiable copy of the current object. The cop/s IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object Instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object Is reclaimed by garbage collection. Inherited 
from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



FloatKeyFrameCollection 
GetCurrentSegmentValues 

GetHashCode 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerifChangeable 

OnChanged 

PropagateEventHandler 
Read Preamble 



TODO 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this method 
has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 



412 



ReferenceEquals 

ToString 
Validate 

ValidateObjectState 
WritePostscript 

WritePreamble 



a valid Ul context. This method should be called before any sinnple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the cunrent Object. Inherited from Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid user interface (Ul) context. This method should be called before 
any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Implementation of Count. 

The value specified in the last KeyFrame. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 



CanMakeUnchangeable 



Count 
Destination 

IsChangeable 

Item 



StatusOfNextUse 



UlContext 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



FloatModifier Class 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 

Changeable. 

Creates a copy of this FloatModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
EmbeddedChangeableReader returns a reference to the member This reference should then be 
. reassigned to the original member variable. Classes that derive from 



CloneDownToUnchangeable 
Copy 

Copy 
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EmbeddedChangeableWriter 
Equals 

Finalize 

FloatModifier 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
opjmplicit 

PropagateEventHandler 

Read Preamble 

ReferenceEquals 

SetDefaultParentTlmeiine 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object, 

Gets the Type of the current instance, inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a FloatModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier, 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 
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Pr perty 



AliowChangeableReferenceOverride 



CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOvemdingBaseVatue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Descripti n 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



FloatTimedModifier Class 



Method 



Beginin 
CloneCore 



CloneDownToUnchangeable 
Copy 



Copy 

Copy 
Disable 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this FloatModifier Inherited from FloatModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this FloatTimedModifier 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
retums a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 



EmbeddedChangeableWriter 
Enable 
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Endin 

Equals 

FilllnClone 

Finalize 

FloatTimedModifier 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 



ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from FloatModifter. 
Inherited from FloatModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a FloatModifier Inherited 
from FloatModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
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WritePreamble 



Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set Inherited from Changeable. 



Property 



Acceleration 



AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CunrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single fonA^ard iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is 
only used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is cunrently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a 
fill period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If 
this value is greater than the simple duration of the animation, it 
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Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



will repeat itself until the tinne specified by this property. 

Gets or sets the aninnation's behavior when it is told to restart- 
that is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



IntAnimationCollection Class 

Definition. Represents a collection of IntModifier animations. 



Method 



Description 

The Add(lntModifier) and Add(Object) methods add animations to the 
collection. The Add(lnt32,lntAnimationCollection) method calculates the 
current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified IntModifier. 

Creates a copy of this IntAnimationCollection. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Copies the entire IntAnimationCollection to the specified one-dimensional 
array, starting at the specified index of the target array. 
Inherited from AnimationCollection.* 



Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 

Accesses the specified Changeable data member, processes it, and 
EmbeddedChangeableReader returns a reference to the member. This reference should then be 
. reassigned to the original member variable. Classes that derive from 
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EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

IntAnimationCollection 

MakeU nchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeabie 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreannble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToStrlng 

ValldateObjectState 



Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Creates an empty IntAnimationCollection with a default capacity for a 
single animation. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
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WritePostscript 
WritePreamble 



Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 
CanMakeUnchangeable 



Count 
CountlmpI 
Empty 

IsChangeable 

IsChanging 
IsFixedSize 
IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



An unchangeable empty IntAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited ft-om Changeable. 



The AnimationCollection classes, such as IntAnimationCollection, provide you with more control over how 
you animate a property than a single animation could. Each of the AnimationCollection classes effectively 
functions as a single composite animation, using all the animations in the collection to animate a base 
value. When a property requests the cun-ent value of an IntAnimationCollection, the property calls the 
IntAnimationCollection's GetValue method and passes it the property's base value. The first animation in 
the collection processes this base value and produces a result, which is then passed to the next 
animation in the collection, and so on. until the value has been processed by all the animations in the 
collection. 
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This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the propert/s corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button CanvasTop="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount-"500" 
AutoReverse='True'7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200'*> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 
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In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



IntModifier Class 



Method 

CloneCore 

CloneDownToUnchangeable 

Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

IntModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MembenA^iseClone 

ModifyHandlerlfChangeable 



Description 

Returns a modifiable shallow or deep clone of the cunrent object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this IntModifier 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this method 
has no effect. Inherited from Changeable. 
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OnChanged 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Called when the current object is nnodified. Classes that derive from j 
Changed should call this method after they have been modified. Inherited | 
from Changeable. 

Implicitly creates an AnimationCollection from a IntModifier 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier 
Returns a String that represents the current Object. Inherited from Object. 
Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from Changeable. 
Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid user interface (Ul) context. This method should be called before 
any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that Indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 
IsChangeable 



IsChanging 



IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



intlimedlVI difier Class 

Method Description 
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Beginin 
CloneCore 

CloneDownToUnchangeable 

Copy 

Copy 
Copy 

Disable 



Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object Inherited from 

Changeable. 

Returns a modifiable copy of the current object The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this IntTimedModifier 
Creates a copy of this IntModifier Inherited from IntModifier 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



EmbeddedChangeableWriter 

Enable 
Endin 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

IntTimedModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerifChangeable 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object 

Gets the Type of the current instance. Inherited from Object 
Inherited from IntModifier. 
Inherited from IntModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
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OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a IntModifier Inherited 
from IntModifier 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Detemnines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration ^^^^ fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeabteHelper.UseChangeable. to help 
^ determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
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Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself until the time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



LengthAnimation Class 

Definition: Used to animate properties that accept a Length value. 

Method Description 

3gQj^lP Starts or restarts the animation at the specified offset from the current 
time. Inherited from LengthTimedModifier. 
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CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Disable 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 

Enable 

Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

LengthAnimation 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 



Innplementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this LengthTimedModlfier Inherited from 

LengthTimedModifier. 

Creates a copy of this LengthModifier Inherited from LengthModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from LengthTimedModifier. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from LengthTimedModifier. 

Schedules an interactive end time. Inherited from LengthTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from LengthTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the value of the animation at the current time. 

Inherited from LengthModifier. 

Inherited from Modifier. 

Initializes a new instance of the LengthAnimation class. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 
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opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Implicitly creates an AnimationCollection from a 
LengthModifier Inherited from LengthModifier. 

Pauses this timeline. Inherited from LengthTimedModifier. 

PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from LengthTimedModifier. 

Moves the current position of the animation backwards or forwards from 

either the current time, the Begin time, or the End time. Inherited from 

LengthTimedModifier. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. Inherited from LengthTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
AutoReverse reverse after it completes its fonA/ard iteration. Inherited from 

LengthTimedModifier. 

Begin ^^^^ animation. Inherited 

from LengthTimedModifier. 

By or sets the total amount by which the animation changes its 

starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from LengthTimedModifier. 

Gets the current time value of the animation. Inherited from 
LengthTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
Deceleration duration spent in the deceleration phase. Inherited from 

LengthTimedModifier. 

Duration length of time the animation takes to complete a 

single fonward iteration, also known as the simple duration of an 



CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 
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End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 
IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 
Restart 

RestartDefault 
Speed 



animation. Inherited from LengthTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
LengthTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
LengthTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from LengthTimedModifier. 
Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from LengthTimedModifier. 

Gets or sets the starting value of an animation. 

InterpolationMethod 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 

from LengthTimedModifier. 

IsCumulative 

Inherited from LengthTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from LengthTimedModifier. 

Gets a value that indicates whether the animation is active or in a fill 

period. Inherited from LengthTimedModifier. 

Gets a value that indicates whether the animation is active and 

paused. Inherited from LengthTimedModifier. 

Gets a value that indicates whether the animation is currently 

moving in the opposite direction of its parent timeline. Inherited from 

LengthTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from LengthTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from LengthTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from LengthTimedModifier. 
Gets or sets the total length of time the animation should play. If this 
value is great than the simple duration of the animation, it will repeat 
itself for the length of time specified by this property. Inherited from 
LengthTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from LengthTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from 
LengthTimedModifier. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
LengthTimedModifier. 
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StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseValue 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
Is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from LengthTimedModifier. 
Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransfonn to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, pattems change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 



<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr> 



<Rectangle 
RectangleTop="20" 
RectangleLen="20" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Red" 
StrokeThickness="5"> 



<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif' TileMode="Tile"/> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!- Animate the Rectangle's width: -> 
<LengthAnimationCollection> 
<LengthAnimation 

To="600" Duration="10" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle. RectangleWidth> 

</Rectangle> 
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When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question nnarks that make up the pattern do not grow larger. 



In the next example, a TransfonnDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation Is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator AffectsLayout=Talse"> 
<TransformDecorator.Transform> 

<!- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransfonn ScaleX="1" ScaleY="1"> 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Duration="10" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.Fill> 
<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode='Tile7> 
</Rectangle.Fill> 
</Rectangle> 
</Transf omn Decorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor. When animating a designated animation property — 
properties of the form PropertyNameAnlmations, such as the ScaleXAnimations property in the previous 
example — you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the elements children are not resized, unless their size and position are dependent on the 
size of their parent element. 

This example demonstrates how to use the By, From, and To properties of animations to set an 
animation's starting and ending values in "XAML". In the following markup, LengthAnimation objects are 
used to animate the endpoints of five Line elements. Although this example uses the LengthAnimation, 
the behavior of the From. To, and By properties is the same for all the animation classes. 
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In the first markup fragment, the X2 attribute of the first line is animated from 50 to 100 over a duration of 
10 seconds. Because the From and To properties of the LengthAnimation are set, the animation ignores 
the line's base value, starting at the specified From value and moving toward the specified To value. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line ID="Line1" X1="10" Y1="10" X2="100" Y2="50" 
Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation From="50" To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The second line's animation has only its To property set. When the From value of an animation Isn't set, 
the animation uses the base value of the property it is animating or the ending value of a previous 
animation. In this example, the animation uses the base value of the line's X2 property, 100, as its starting 
value. 

<Line ID="Line2" X1="10" Y1="70" X2="100" Y2="70" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The third line's animation has only its By property set. The By of an animation specifies "by how much" 
the animation changes a value over its duration. As in the previous example, the animation uses the base 
value of the property it is animating or the ending value of a previous animation. In this example, the 
animation uses the base value of the line's X2 property. 100. as its starting value, and adds 300 to that 
value over a duration of 10 seconds. 

<Line ID="Line3" X1="10" Y1="130" X2="100" Y2="130" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 
<LengthAnimation By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fourth line's animation has its By and From properties set. As a result, the line's X2 attribute is 
animated from 50 to to 350 over a duration of 10 seconds. 

<Line ID="Line4" X1="10" Y1="190" X2="100" Y2="190" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 
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The fifth line's animation has only its From value set When an animation has no explicit destination value, 
it uses the base value of the property it is animating or the output of a previous animation as its 
destination value. In this case, the line's X2 attribute is animated from 50 to 100. 

<Line ID="Line5" X1="10" Y1="250" X2="100" Y2="250" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to TIme.indefinite or set its RepeatCount property to 
double. Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
LengthAnimation, the procedure is the same for all the animation classes. 

<Canvas ID="roor 
xmlns="http;//schemas.microsoft.com/2003/xamr'> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 

RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

//C# 

Line myLine = new Line(); 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation. Duration = new Time(IOOOO); 
myLengthAnimation. RepeatDuration = Time.lndefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
coIlection.Add(myLengthAnimation); 

myLine.SetAnlmations(Line.X2Property, collection); 

'VB.NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon. Windows. Media. Animation.LengthAnimation 
myLengthAnimation.From = new MSAvalon. Windows. Length(30) 
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myLengthAnimationTo = new MSAvalon.Windows.Length(300) 
myLengthAnimation. Duration = new MSAvalon.Windows, Media. Animation.Time(1 0000) 
myLengthAnimation.RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimatlonCollection 
collection.Add(myLengthAnimation) 

myLlne.SetAnimations(Line.X2Property, collection) 



LengthAnimationCollection Class 

Definition: Represents a collection of LengthModifier animations. 



Method 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 
CopyTo 
Disable 
DisablelmpI 



Description 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this LengthAnimationCollection. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 

GetEnumeratorlmpI 

GetHashCode 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 
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GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

LengthAnimationCollection 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlertfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the cunrent value of the animation. 
Provides a Modifier at a given index. 



Creates an empty LengthAnimationCollection with a default capacity for a 
single animation. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCoIlection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 



AnimationType 
CanMakeUnchangeable 



promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
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Changeable. 

Inherited from AnimationCollection. 



An unchangeable empty LengthAnimationCoilection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as LengthAnimationCoilection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an LengthAnimationCoilection, the property 
calls the LengthAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate the size of an element using "Longhom" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransfonn to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattem to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCoilection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 



Count 

CountlmpI 

Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 

StatusOfNextUse 

SyncRoot 
UlContext 
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<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Rectangle 
RectangleTop="20" 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Red" 
StrokeThickness="5"> 

<Rectangle.Fill> 

<lmageBaish ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode="Tile7> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!- Animate the Rectangle's width: -> 
<LengthAnlmationCollection> 
<LengthAnimation 

To="600" Duration="10" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle. RectangleWidth> 

</Rectangle> 



When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimatlon is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnlmations attribute. The DoubleAnimatlon animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<Transfon7iDecorator AffectsLayout="False"> 
<TransformDecorator.Transfomi> 

<!- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX="1" ScaleY="1"> 
<ScaleTransform.ScaleXAnimations> 
<DoubleAnimation From="1"To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Duration="10" /> 
</ScaleTransform.ScaleXAnimations> 
</ScaleTransform> 

</T ransformDecorator.Transform> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
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<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100.100" ViewPortUnits="Absolute" 
lmageSource="help.gir TileMode='Tile7> 
</Rectangle.Fill> 
</Rectangle> 
</TransformDecorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations, such as the ScaleXAnimations property in the previous 
example— you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as In the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element 



LengthKeyFrameCollection Class 



Method 



Add 

CloneCore 



CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetCurrentSegmentValues 
GetHashCode 
GetType 

LengthKeyFrameCollection 



Description 

Strongly typed implementation of Add. 
Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 

Changeable. 

Creates a new LengthKeyFrameCollection 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 

Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object 
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MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

ToString 
Validate 

ValtdateObjectState 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the cun^ent Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 

OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 

from a valid user interface (Ul) context. This method should be called 

before any simple members are set. Inherited from Changeable. 



Property 



AllowChangeableReferenceOverride 



CanMakeUnchangeable 

Count 
Destination 

IsChangeable 

Item 



StatusOfNextUse 



UlContext 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Implementation of Count. 

The value specified in the last KeyFrame. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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LengthModifier Class 



Meth d 

CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

EmbeddedChangeableReader 

EmbeddedChangeableWriter 
Equals 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

LengthModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
opjmplicit 

PropagateEventHandler 
ReadPreamble 



Descripti n 

Returns a modifiable shallow or deep clone of the current object This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this LengthModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perfonm other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a LengthModifier 
Shares a Changed event handler with the current object's data 
members or removes it Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 



440 



ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method, inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 

AllowChangeableReferenceOvenride 

CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOverrtdingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Description 

Used in conjunction with the ChangeableUsageOverride type sent 
in as a parameter to ChangeableHeiper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited 
from Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable, 

Gets a value that indicates whether the animation Is 
active. Inherited from Modifier. 

Gets a value that indicates whether the animation is active or in a 
fill period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable 
object is considered used in the following situations: the object is 
set into a Property System property, the object is used as a sub- 
object in a complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element. In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, patterns change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 

of 1 0 seconds. 



<Canvas ID="root" 
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xmlns="http://schemas.microsoft.com/2003/xaml"> 



<Rectangle 
RectangleTop="20" 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Red" 
StrokeThickness="5"> 

<Rectangle.Fill> 
<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
lmageSource="help.gif' TileMode="Tile'7> 
</Rectangle.Fill> 

<Rectangle.RectangleWidth> 
<!- Animate the Rectangle's width: -> 
<LengthAninnationCollection> 
<LengthAnimation 

To="600" Duration="10" AutoReverse="true" RepeatCount="50" /> 
</LengthAninnationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 

When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 

In the next example, a TransformDecorator is used to apply a ScaleTransfomri to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator AffectsLayout="False"> 
<TransfomiDecorator.Transform> 

<!- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransform ScaleX="1" Scale Y="1"> 
<ScaleTransfonD.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Duration="10" /> 
</ScaleTransfonn.ScaleXAnimations> 
</ScaleTransform> 

</TransformDecorator.Transfomi> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWldth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.FilI> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 
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lmageSource="help.gif TileMode="Tile7> 
</Rectangle.Fill> 
</Rectangle> 
</Transform Decorator> 

</Canvas> 

In the previous example, the DoubleAnimationCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form PropertyNameAnimations. such as the ScaleXAnimations property in the previous 
example— you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 



LengthTimedModifier Class 



Method 



Beginin 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this LengthModifier Inherited from LengthModifier. 
Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this LengthTimedModifier 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 

Determines whether two Object instances are equal. Inherited from 
Object. 



EmbeddedChangeableWriter 



Enable 



Endin 
Equals 
FilllnClone 
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Finalize 



GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

LengthTlmedModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimellne 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from LengthModifier. 
Inherited from LengthModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a LengthModifier Inherited 
from LengthModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 



Acceleration 



Descripti n 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 
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AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 



Used in conjunction with the ChangeableUsageOverride type sent 
in as a paranneter to ChangeableHelper.UseChangeable, to help 
detennine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward Iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the cun-ent animation and its child timelines. 

Gets a Boolean that indicates whether the object is cun-ently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a 
fill period. 

Gets a value that indicates whether the animation is active and 

paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If 
this value is great than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
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animation, compared to its parent timeline. 



Timeline 



StatusOfNextUse 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into 
a Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 



UsesBaseValue 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



This example demonstrates how to animate the size of an element using "Longhorn" markup language 
(code-named "XAML"). There are multiple ways to animate the size of an element: directly animate the 
height and width attributes of the element, or apply an animated ScaleTransform to the element In this 
example, two Rectangle elements are resized using these methods. One rectangle is resized by 
animating its RectangleWidth attribute and another is resized by animating a ScaleTransform applied to 
the rectangle. Each rectangle is filled with a pattern to highlight the differences between the two resizing 
methods. Initially, the two patterns look the same, but as the rectangles are resized, pattems change 
depending on how their containing rectangle is resized. 

In the first example, a Rectangle element's RectangleWidth property is animated using a 
LengthAnimationCollection and a LengthAnimation. The LengthAnimation object in this example animates 
the rectangle's RectangleWidth from its base value of 200 To a destination value of 600 over a Duration 
of 10 seconds. 

<Canvas ID="root" 

xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Rectangle 
RectangleTop="20" 
RectangleLeft="20" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Red" 
StrokeThickness="5"> 

<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100.100" ViewPortUnits="Absolute" 
lmageSource="help.gif TileMode="Tile7> 
</Rectangle,Fill> 

<Rectangle. RectangleWidth> 
<l- Animate the Rectangle's width: -> 
<LengthAnimationCoHection> 
<LengthAnimation 

To="600" Duration="10" AutoReverse="true" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Rectangle.RectangleWidth> 

</Rectangle> 
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When the previous "XAML" is run, more of the pattern is exposed as the rectangle expands; however, the 
question marks that make up the pattern do not grow larger. 



In the next example, a TransformDecorator is used to apply a ScaleTransform to a rectangle. A 
DoubleAnimation is used to animate the ScaleTransform object's ScaleX value using the 
ScaleXAnimations attribute. The DoubleAnimation animates the ScaleX value From 1 To a destination 
value of 3 over a Duration of 10 seconds. As a result, the rectangle's width is scaled from 100 percent (its 
starting size) to 300 percent over ten seconds. 

<TransformDecorator AffectsLayout="False"> 
<TransformDecorator.Transfomn> 

<l- Use the ScaleTransform to enlarge the rectangle -> 
<ScaleTransfonn ScaleX="1" Scale Y="1"> 
<ScaleTransfon7i.ScaleXAnimations> 
<DoubleAnimation From="1" To="3" RepeatCount="30" 
AutoReverse="True" Begin="0" Duration="10" /> 
</ScaleTransfonn.ScaleXAnimations> 
</ScaleTransform> 

</TransfomnDecorator.Transfon7i> 

<Rectangle 
RectangleLeft="20" 
RectangleTop="200" 
RectangleWidth="200" 
RectangleHeight="150" 
Stroke="Black" 
StrokeThickness="3"> 
<Rectangle.Fill> 

<lmageBrush ViewPort="0,0 100,100" ViewPortUnits="Absolute" 

lmageSource="help.gif' TileMode="Tjle7> 
</Rectangle.Fill> 
</Rectangle> 
</TransfomnDecorator> 

</Canvas> 

In the previous example, the DoubleAnimatlonCollection tag, <DoubleAnimationCollection>, is omitted 
when animating the transformation's scale factor. When animating a designated animation property- 
properties of the form Property Name Animations, such as the ScaleXAnimations property in the previous 
example — you may omit the animation collection tag. However, when animating a property of a Ul 
element— those classes that derive from UlElement— you must nest the animations within an animation 
collection tag. 

When the second rectangle expands, the objects in the pattern also grow larger, unlike in the first 
rectangle. The pattern behaves this way because when you transform an element the entire element and 
its child elements are transformed. When you directly alter the size of an element, as in the case of the 
first rectangle, the element's children are not resized, unless their size and position are dependent on the 
size of their parent element. 



L ngAnimationC llection Class 

Definition: Represents a collection of LongModifier animations. 
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Meth d 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 



Descripti n 

The Add(LongModifjer) and Add(Object) methods add animations to the 
collection. The Add(lnt64,LongAnimationCollection) method calculates 
the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified LongModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this LongAnimationCollection. 
Copies the entire LongAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorimpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 
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LongAnimationCollection 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Creates an empty LongAnimationCollection with a default capacity for a 
single animation. 

Makes an object Immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOvemde type sent in 
AllowChangeableReferenceOverride ?® ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 

CanMakeUnchangeable 

Count 
CountlmpI 
Empty 

IsChangeable 



An unchangeable empty LongAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 
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Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given Index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as LongAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an LongAnimationCollection. the property 
calls the LongAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWldth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimatlon is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there Is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Left="20" 
Helght="30" Width="200"> 

<Button.Width> 



IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUslngBaseValuelmpI 
Item 

Item 

StatusOfNextUse 

SyncRoot 
UlContext 
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<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top='70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolldCoIorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration='7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 



In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



LongModifier Class 



</Canvas> 



Method 



Description 



CloneCore 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 



CloneDownToUnchangeable 
Copy 



Retums an immutable copy of the specified object. Inherited from 
Changeable. 



Copy 



Creates a copy of this LongModifier 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. • 



451 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 
LongModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 

WritePostscript 
WritePreamble 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a LongModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Retums a String that represents the cun-ent Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 

Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
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from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride !® ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 



CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



LongTinriedModifier Class 



BeginIn 



CloneCore 



CloneDownToU nchangeable 

Copy 
Copy 



Method Description 

Starts or restarts the animation at the specified offset from the cunrent 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this LongModifier Inherited from LongModifier. 
Creates a copy of this LongTimedModifier 
Returns a modifiable copy of the current object. The copy's 
Copy IsChangeable property is true and its StatusOfNextUse is 

Unchangeable. Inherited from Changeable. 

Disable Disables this timeline, after which the timeline can no longer become 

active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 

EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

EmbeddedChangeableWriter Processes a modified Changeable data member and returns a 
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EmbeddedChangeableWriter 

Enable 

Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

LongTimedModifier 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 



Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 

Determines whether two Object Instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from LongModifier. 
Inherited from LongModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a LongModifier Inherited 
from LongModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
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Changeable, 

WritePostscript Causes the current object to validate itself and then invokes the 

OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 

WritePreamble ^^^^ ^ ^^"^ ^' context. This method should be called before any simple 

members are set. Inherited from Changeable. 



Property Description 

Acceleration ^^^^ fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single fonA^ard iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TImeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property Is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 
Gets a value that indicates whether the animation is active. 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
IsChangeable 



IsChanging 
IsEnabled 

IsForwardProgressIng 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimeline 

Progress 



Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 
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RepeatCount 
RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



MatrixAnimationCollection Class 

Definition: Represents a collection of MatrixModifier animations. 



Method 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 
Disable 
DisablelmpI 

EmbeddedChangeableReader 



Description 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection In markup to 
an element. 

CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this MatrixAnimationCollection. 
Returns a modifiable copy of the current object The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Inherited from AnimationCollection. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
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Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 

MatrixAnlmationCollection 

MembenA/iseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTlmeline 
SetValuelmpI 



Determines v\/hether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates an empty MatrixAnimationCollection with a default capacity for 
a single animation. 

Creates a shallow copy of the current Object. Inherited from Object 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 
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ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Pa^n^eter to ChangeabteHelperUseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 

CanMakeUnchangeable 

Count 
CounttmpI 
Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 

SyncRoot 
UlContext 



An unchangeable empty MatrixAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Retums true if at least one of the animations in the animation list is 
cunrently active. Inherited from AnimationCollection. 

Retums true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as MatrixAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
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a base value. When a property requests the current value of an MatrixAnimationCollection, the property 
calls the MatrixAnimationCollection*s GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property, 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas. Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 
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Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example— you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



MatrixModifier Class 



CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Retums an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this MatrixModifier 
Accesses the specified Changeable data member, processes it, and 
retums a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and retums a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the cunrent instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 

GetHashCode 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 

MatrixModifier 

MembenviseClone 

ModifyHandlerifChangeable 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
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OnChanged 
opjmplicit 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a MatrixModifier 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from Object 

Verifies that the current object has a valid state. If the object is In an 

invalid state, this method throws an exception. Inherited from 

Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOvenide type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



IMatrixTimedModifler Class 
Meth d 



Description 
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Beginin 
CloneCore 



Starts or restarts the animation at the specified offset from the current 
time. 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this MatrixModifier Inherited from MatrixModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this MatrixTimedModifier 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. 
This method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



EmbeddedChangeableWriter 



Enable 



Endin 
Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 

MatrixTimedModifier 

MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from MatrixModifier. 
Inherited from MatrixModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is cun-ently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
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opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a MatrixModifier Inherited 
from MatrixModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object 
Resumes this timeline. 

Moves the current position of the animation backwards or fonwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception, inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its fonvard iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the cun-ent iteration of the animation. 
Gets the current time value of the animation. 

Deceleration ^^^^ ^ ^^^^^ represents the fraction of the simple 

duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
Duration single fonward iteration, also known as the simple duration of an 

animation. 

End Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
EndSync implicit duration of an animation is determined. This property is only 

used if the Duration property is not explicitly set. 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 
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Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



Gets or sets a value that specifies the state of an object when its 

animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



Modifier Class 



Method 



CloneCore 



CloneDownToUnchangeable 



Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 
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Copy 



Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Detemnines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object, 

Used to be internal. Can be private or something when we move to 
generics. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValuelmpI 
IModifier.GetValue 



MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseClone 

Modifier 

ModifyHandlerifChangeable 



OnChanged 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 

Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
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WritePreamble 



Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Pr party 

AllowChangeableReferenceOverride 

CanMakeUnchangeable 

IsChangeable 
IsChanging 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelper.UseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue 



Object An imationColiection Class 

Definition: Represents a collection of ObjectModifier animations. 



Method 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 



Description 

The Add(ObjectModifier) and Add(Object) methods add animations to 
the collection. The Add(Object,ObjectAnimationCollection) method 
calculates the current value of the specified collection based on the 
specified base value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified ObjectModifier. 

Creates a copy of this ObjectAnimationCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
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CopyTo 

Disable 
DisablelmpI 



Copies the entire ObjectAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited fronn AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

ObjectAnimationCollection 

OnChanged 
op_Addition 
opjmpiicit 

PropagateEventHandier 
ReadPreamble 

ReferenceEquals 



Detenmines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable: after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Creates an empty ObjectAnimationCollection with a default capacity for 
a single animation. 

OnChanged 



Implementation of PropagateEventHandier. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 
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Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the cunrent Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 

Changeable. 

Inherited from AnimationCollection. 



AnimationType 
CanMakeUnchangeable 



Count 
CountlmpI 
Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUstngBaseValuelmpI 

Item 

Item 



StatusOfNextUse 



SyncRoot 
UlContext 



An unchangeable empty ObjectAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the cunrent object. The UlContext is used for 
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maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as ObjectAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an ObjectAnimationCollection, the property 
calls the ObjectAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a Length Animation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there Is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property, 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True'7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush. Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height=:"30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
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<ColorAnimation From="Red" To="Blue" Duration='7" 
RepeatCou nt="500" AutoReverse="True'7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



ObjectModifier Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ObjectModifier 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and retums a reference 

to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object, 

Serves as a hash function for a particular type, suitable for use in 
GetHashCode hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
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MemberwiseClone 

ModifyHandlerlfChangeable 

ObjectModifier 

OnChanged 

opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Creates a shallow copy of the current Object. Inherited from Object 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable, 

Implicitly creates an AnimationCollection from a ObjectModifier 

Shares a Changed event handler with the cunrent object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the cun-ent object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelperUseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOverridingBaseValue 



StatusOfNextUse 



UlContext 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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UsesBaseValue 



UsesBaseValue Inherited from Modifier. 



ObjectTimedM difier Class 



Method 



Beginin 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this ObjectTimedModifier 
Creates a copy of this ObjectModifier Inherited from ObjectModifier. 
Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
Enable ParentTimeline property. This allows the timeline to become active. This 

method throws an exception if the ParentTimeline property is null. 
Endin Schedules an interactive end time. 



CloneCore 

CloneDownToUnchangeable 

Copy 

Copy 
Copy 

Disable 



EmbeddedChangeableWriter 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 

Inherited from ObjectModifier. 

Inherited from ObjectModifier. 

Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
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ObjectTimedModifier 
OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



object is not modifiable — if its IsChangeable property is false — this method 
has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a ObjectModifier Inherited 
from ObjectModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid user interface (Ul) context. This method should be called before 
any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or fonvards from 
either the current time, the Begin time, or the End time. 
SetDefaultParentTimeline Inherited from Modifier. 
Returns a String that represents the current Object. Inherited from Object. 
Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from Changeable. 
Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeabteHelper.UseChangeable, to help 

determine when a Changeable being put into "use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 
Gets the current time value of the animation. 

Deceleration ^^^^ ^ \/3\ue that represents the fraction of the simple 

duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
Duration single fon^/ard iteration, also known as the simple duration of an 

animation. 

End Gets or sets the maximum end time of the animation. 

EndSync Gets or sets a TimeEndSync enumeration that specifies how the 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 
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Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOvemdingBaseValue 

IsPaused 

isReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is great than the simple duration of the animation, it will repeat 
itself for the length of time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time Is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to Its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



PathAnimation Class 

Definition: This animation can be used inside of a MatrixAnimationCollection to move a visual object 
along a path. 

Method Descripti n | 

Beginin Starts or restarts the animation at the specified offset from the current | 
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CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Disable 



time. Inherited from MatrixTimedModifier. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this MatrixTimedModifier Inherited from 
MatrixTimedModifier 

Creates a copy of this MatrixModifier Inherited from MatrixModifier. 

Retums a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from MatrixTimedModifier. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from MatrixTimedModifier 



EmbeddedChangeableWriter 



Enable 



Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifierGetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerifChangeable 
OnChanged 



Schedules an interactive end time. Inherited from MatrixTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from MatrixTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the current matrix value for this animation. 
Inherited from MatrixModifier 
Inherited from Modifier 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 
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opjmplicit 

PathAnimation 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Implicitly creates an AnimationCollection from a MatrixModifier Inherited 
from MatrixModifier. 

Creates a new PathAnimation class. 

Pauses this timeline. Inherited from MatrixTimedModifier 

Inherited from MatrixTimedModifier. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object Instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from MatrixTimedModifier. 

Moves the current position of the animation backwards or forwards from 

either the current time, the Begin time, or the End time. Inherited from 

MatrixTimedModifier. 

Changes the default parent timeline for this animation. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Acceleration 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. Inherited from MatrixTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

detemnme when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. Inherited from 
MatrixTimedModifier. 



AutoReverse 



Begin 

CanMakeUnchangeable 

CurrentRepeat 

CunrentTime 

Deceleration 

DoesRotateWithTangent 



Gets or sets an offset to the start time of the animation. Inherited 
from MatrixTimedModifier. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from MatrixTimedModifier, 

Gets the current time value of the animation. Inherited from 
MatrixTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
MatrixTimedModifier. 

If this is set to true, the object will rotate along with the tangent to 
the path. 
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Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimeline 
PathGeometry 
Progress 

RepeatCount 
RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 



Gets or sets the length of time the animation takes to complete a 
single fonA/ard iteration, also known as the simple duration of an 
animation. Inherited from MatrixTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
MatrixTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
MatrixTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from MatrixTimedModifier 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from MatrixTimedModifier. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from MatrixTimedModifier. 

Inherited from MatrixTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from MatrixTimedModifier. 
Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from MatrixTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from MatrixTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 

MatrixTimedModifier. 

Gets or sets the default parent timeline of the animation. Inherited 
from MatrixTimedModifier. 

This geometry specifies the path. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from MatrixTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from MatrixTimedModifier 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this 
property. Inherited from MatrixTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from MatrixTimedModifier 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from 
MatrixTimedModifier 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
MatrixTimedModifier 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
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is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Timeline Inherited from MatrixTimedModifier. 

UlContext ^^^^ UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Currently always returns false. 



PolntAnimation Class 

Definition: Used to animate properties that accept Point values. 



Method 

Beginin 
CloneCore 

CloneDownToUnchangeable 

Copy 

Copy 



Description 

Starts or restarts the animation at the specified offset from the current 
time. Inherited from PointTimedModifier. 

Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this PointModifier Inherited from PointModifier. 

Creates a copy of this PointTimedModifier Inherited from 
PointTimedModifier. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
Copy property is true and its StatusOfNextUse is Unchangeable. Inherited from 

Changeable. 

Disables this timeline, after which the timeline can no longer become 
Disable active. The timeline can be re-enabled with a call to Enable. Inherited 

from PointTimedModifier. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from PointTimedModifier. 

Schedules an interactive end time. Inherited from PointTimedModifier. 

Equals Determines whether two Object instances are equal. Inherited from 

Object. 

Inherited from PointTimedModifier. 



EmbeddedChangeableWriter 



Enable 



Endin 



FilllnClone 
Finalize 

GetHashCode 
GetType 



Allows an Object to attempt to free resources and perfomi other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
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GetValue 

GetValuelmpI 

IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PointAnimation 
PropagateEventHandler 

Read Preamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Calculates the value of the animation at the current time. 
Inherited from PointModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a PointModifier Inherited 
from PointModifier. 

Pauses this timeline. Inherited from PointTimedModlfier. 
Initializes a new instance of the PointAnimation class. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from PointTimedModlfier. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. Inherited from 
PointTimedModlfier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user intert'ace (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Acceleration 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. Inherited from PointTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 



AutoReverse 



promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. Inherited from 
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Begin 
By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 

IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressIng 

IsOvem'dingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 



PointTimedModifier, 

Gets or sets an offset to the start time of the animation. Inherited 
from PointTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from PointTimedModifier. 

Gets the current time value of the animation. Inherited from 
PointTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
PointTimedModifier. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from PointTimedModifier 

Gets or sets the maximum end time of the animation. Inherited from 
PointTimedModifier. 

Not supported. Gets or sets a TimeEndSync enumeration that 
specifies how the implicit duration of an animation is determined. 
This property is only used if the Duration property is not explicitly 
set. Inherited from PointTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from PointTimedModifier. 
Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from PointTimedModifier. 

Gets or sets the starting value of an animation. 

Gets or sets a value that specifies how output values are calculated 
for the animation. 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from PointTimedModifier. 

IsCumulative 

Inherited from PointTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from PointTimedModifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from PointTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from PointTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
PointTimedModifier. 

KeyValues 

Gets or sets tho default parent timeline of the animation. Inherited 
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from PointTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from PointTimedModifier. 

Gets or sets the number of times an animation should 
repeat. Inherited from PointTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this 
property. Inherited from PointTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from PointTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from PointTimedModifier. 
Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
PointTimedModifier, 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from PointTimedModifier. 
Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to use the By, From, and To properties of animations to set an 
animation's starting and ending values in "Longhorn" markup language (code-named "XAML"). In the 
following markup, LengthAnimation objects are used to animate the endpoints of five Line elements. 
Although this example uses the LengthAnimation, the behavior of the From, To. and By properties is the 
same for all the animation classes. 

In the first mari<up fragment, the X2 attribute of the first line is animated from 50 to 100 over a duration of 
10 seconds. Because the From and To properties of the LengthAnimation are set. the animation ignores 
the line's base value, starting at the specified From value and moving toward the specified To value. 

<Canvas lD="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Line ID="Line1" XI ="10" Y1="10" X2="100" Y2="50" 
Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation From="50" To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The second line's animation has only its To property set. When the From value of an animation isn't set, 
the animation uses the base value of the property it is animating or the ending value of a previous 



Progress 
RepeatCount 

RepeatDuration 
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To 

UlContext 
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animation. In this example, the animation uses the base value of the line's X2 property, 100, as its starting 
value. 

<Line ID="Line2" X1="10" Y1='70" X2="100" Y2='70" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The third line's animation has only its By property set. The By of an animation specifies "by how much" 
the animation changes a value over its duration. As in the previous example, the animation uses the base 
value of the property it is animating or the ending value of a previous animation. In this example, the 
animation uses the base value of the line's X2 property. 100, as its starting value, and adds 300 to that 
value over a duration of 10 seconds. 

<Line ID="Line3" X1="10" Y1="130" X2="100" Y2="130" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fourth line's animation has its By and From properties set. As a result, the line's X2 attribute is 
animated from 50 to to 350 over a duration of 10 seconds. 

<Line ID="Line4" X1="10" Y1="190" X2="100" Y2="190" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation From="50" By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fifth line's animation has only its From value set. When an animation has no explicit destination value, 
it uses the base value of the property it is animating or the output of a previous animation as its 
destination value. In this case, the line's X2 attribute is animated from 50 to 100. 

<Line ID="Line5" X1="10" Y1="250" X2="100" Y2="250" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<LengthAnimationCollection> 

<LengthAnimation From="50" Duratlon="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time. Indefinite or set its RepeatCount property to 
double. Positivel nfinity. 
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In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
LengthAnimation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoftxom/2003/xamr'> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 

<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line,X2> 
</Line> 

</Canvas> 

//C# 

Line myLlne = new Line(); 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.From = new Length(30); 
myLengthAnimation. To = new Length(300); 
myLengthAnimation. Duration = new Time(IOOOO): 
myLengthAnimation.RepeatDuration = Time.lndefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnimations(Line.X2Property, collection); 

'VB.NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon.Windows.Media.Animation. LengthAnimation 
myLengthAnimation.From = new MSAvalon. Windows. Length(30) 
myLengthAnimation. To = new MSAvalon.Windows.Length(300) 
myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time{10000) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property, collection) 



PointAnimationCollection Class 

Definition: Represents a collection of PointModifier animations. 

Method Descripti n 

p^^^ The Add(PointModifier) and Add(Object) methods add animations to the 
collection. The Add(Point.PointAnimationCollection) method calculates 
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the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified PointModifier. 

Creates a copy of this PointAnimationCollection. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Copies the entire PointAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 

Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and retums a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 
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GetEnumerator 
GetEnumeratorlmpI 
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Makellnchanaeable 

MakeUnchanqeableCore 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates and returns the output of the animation collection. 
Provides a Modifier at a given index. 



Makes an obiect immutable: after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
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PointAnimationCollection 
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Creates a shallow copy of the current Object Inherited from Object 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object Is not modifiable — if its IsChangeable property Is false— this 
method has no effect Inherited from Changeable. 

OnChanged 



Initializes a new instance of the PointAnimationCollection class. 
Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context This method should be called 
before any simple members are set Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

^ determine when a Changeable being put into use should be 

promoted to "ChangeableReference". Inherited from Changeable. 

Gets the type of animation stored in the collection. 
PointAnimationCollection objects always return the type of 
PointAnimation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 

CanMakeUnchangeable 

Count 
CountlmpI 
Empty 

IsChangeable 

IsChanging 
IsFlxedSize 



An unchangeable empty PointAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 
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IsOvemdingBaseValue 



Returns true if at least one of the animations in the aninnation list is 
currently on. Inherited from AnimationCollection. 



IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 



Gets or sets the animation at the specified index. 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 



Inherited from AnimationCollection. 



Item 



StatusOfNextUse 



SyncRoot 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as PointAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of a PointAnimationCollection, the property 
calls the PointAnimationCollection's GetValue method and passes it the propert/s base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
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</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



PointKeyFrameCollection Class 



Method Description 

Add Strongly typed implementation of Add. 

CloneCore Implementation of CloneCore. 

Returns an immutable copy of the specified object Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a new PointKeyFrameCollection 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 

EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 

retrieved through property calls. Inherited from Changeable. 



CloneDownToUnchangeable 



Copy 



Copy 
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Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Detemnines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into use ' should be 
promoted to "ChangeableReference". Inherited from Changeable. 

CanMakeUnchanaeable ^^^^ Changeable can be made unchangeable. Inherited from 

^ Changeable. 
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Count Implementation of Count 

Destination The value specified in the last KeyFrame. 

IsChanqeable ^ Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Item 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
StatusOfNextUse considered used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used In a 
DrawingContext command. Inherited from Changeable. 

UlContext UiContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 



PointModifier Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract nrjethod must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this PointModifier 
Returns a modifiable copy of the current object The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
GetHashCode hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
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MemberwiseClone 
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Creates a shallow copy of the current Object. Inherited from Object 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is cunrently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 
Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a PointModifier 

Shares a Changed event handler with the current objects data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



CanMakeUnchangeable 

IsChangeable 

isChanging 

IsOverridingBaseValue 



StatusOfNextUse 



UlContext 
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UsesBaseValue 



UsesBaseValue Inherited from Modifier. 



PointTimedM difier Class 



Method 



Beginin 



Description 

Starts or restarts the animation at the specified offset from the current 

time. 



CloneCore 



CloneDownToUnchangeable 

Copy 
Copy 

Copy 



Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this PointTimedModifier 
Creates a copy of this PointModifier Inherited from PointModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
Enable ParentTimeline property. This allows the timeline to become active. This 

method throws an exception if the ParentTimeline property is null. 
Endin Schedules an interactive end time. 



Disable 



EmbeddedChangeableWriter 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MembenviseClone 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from PointModifier. 
Inherited from PointModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 
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ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PointTimedModifier 
PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a PointModifier Inherited 
from PointModifier. 

Pauses this timeline. 



Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration ^^^^ fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 
^ detemiine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its fonA/ard iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 
Gets the current time value of the animation. 

Deceleration ^^^^ ^ ^^'^^ represents the fraction of the simple 

duration spent in the deceleration phase. 

Duration Gets or sets the length of time the animation takes to complete a 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 
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End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseVaiue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseVatue 



single fonA^ard iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 

Gets or sets the animation's behavior when it is told to restart — ^that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



RectAnimation Class 

Definition: Used to animate properties that accept a Rect value. 
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Meth d 

Beginln 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Disable 



Description 

Starts or restarts the animation at the specified offset from the current 
time. Inherited from RectTimedModifier. 

Implementation of CloneCore. 

Retums an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this RectTimedModifier Inherited from 
RectTimedModifier. 

Creates a copy of this RectModifier Inherited from RectModifier. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property Is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. Inherited 
from RectTimedModifier. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from RectTimedModifier. 



EmbeddedChangeableWriter 



Enable 



Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MembenviseClone 

ModifyHandlerlfChangeable 



Schedules an interactive end time. Inherited from RectTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from RectTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the value of the animation at the current time. 
Inherited from RectModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
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OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

RectAnimation 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a RectModifier Inherited 
from RectModifier. 

Pauses this timeline. Inherited from RectTimedModifier. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Creates a new RectAnimation with all properties set to their default 

values. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from RectTimedModifier. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. Inherited from 
RectTimedModifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Acceleration 



Property Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. Inherited from RectTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent In 

AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 
^ determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. Inherited from 
RectTimedModifier. 



AutoReverse 



Begin 
By 

CanMakeUnchangeable 
CurrentRepeat 



Gets or sets an offset to the start time of the animation. Inherited 
from RectTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from RectTimedModifier. 



495 



CurrentTime 
Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 
IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimellne 

Progress 

RepeatCount 

RepeatDuration 

Restart 



Gets the current time value of the animation. Inherited from 
RectTimedModifier 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
RectTimedModifier. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from RectTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
RectTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
RectTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from RectTimedModifier. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from RectTimedModifier. 

Gets or sets the starting value of an animation. 

I nterpolationMethod 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from RectTimedModifier. 

IsCumulative 

Inherited from RectTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from RectTimedModifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from RectTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from RectTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
RectTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from RectTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from RectTimedModifier. 

Gets or sets the number of times an animation should 
repeat. Inherited from RectTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this 
property. Inherited from RectTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
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reached. Inherited from RectTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from RectTimedModifier. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
RectTimedModifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Inherited from RectTimedModifier. 
Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

This example demonstrates how to use the By, From, and To properties of animations to set an 
animation's starting and ending values in "Longhorn" markup language (code-named "XAML"). In the 
following markup, LengthAnimation objects are used to animate the endpoints of five Line elements. 
Although this example uses the LengthAnimation, the behavior of the From, To. and By properties is the 
same for all the animation classes. 

In the first markup fragment, the X2 attribute of the first line is animated from 50 to 100 over a duration of 
10 seconds. Because the From and To properties of the LengthAnimation are set, the animation ignores 
the line's base value, starting at the specified From value and moving toward the specified To value. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr> 

<Line ID="Liner' XI ="10" Y1="10" X2="100" Y2="50" 
Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The second line's animation has only its To property set. When the From value of an animation isn't set, 
the animation uses the base value of the property it is animating or the ending value of a previous 
animation. In this example, the animation uses the base value of the line's X2 property, 100, as its starting 
value. 

<Line ID="Line2" X1="10" Y1="70" X2="100" Y2="70" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation To="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



RestartDefault 
Speed 

StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseValue 
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The third line's animation has only its By property set. The By of an animation specifies "by how much" 
the animation changes a value over its duration. As in the previous example, the animation uses the base 
value of the property it is animating or the ending value of a previous animation. In this example, the 
animation uses the base value of the line's X2 property. 100, as its starting value, and adds 300 to that 
value over a duration of 10 seconds. 

<Line ID="Line3" X1="10" Y1="130" X2="100" Y2="130" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 



The fourth line's animation has its By and From properties set. As a result, the line's X2 attribute is 
animated from 50 to to 350 over a duration of 10 seconds. 

<Llne ID="Line4" X1="10" Y1="190" X2="100" Y2="190" Stroke="Black" StrokeThickness="5"> 
<Line.X2> 
<LengthAnimationCollection> 

<LengthAnimation From="50" By="300" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

The fifth line's animation has only its From value set. When an animation has no explicit destination value, 
it uses the base value of the property it is animating or the output of a previous animation as its 
destination value, in this case, the line's X2 attribute is animated from 50 to 100. 

<Line ID="Line5" X1="10" Y1="250" X2="100" Y2="250'* Stroke="Black" StrokeThickness="5"> 
<Line.X2> 

<Length An imationCollection> 
<LengthAnimation From="50" Duration="10" RepeatCount="50" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

This example demonstrates how to animate a property using "XAML". To animate a property, you 
associate the proper animation collection and animations with the property either directly or using the 
property's corresponding animation property. There are a variety of animation classes, each of which 
animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no Width Animations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
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xmlns- 'http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Lefl="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse='True'7> 
</LengthAnimationCollection> 
</Button.Wiclth> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnlmation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse='True7> 
</SolidColorBrush . ColorAn imations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollectlon>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more infomnation about animating properties, see Animation in "Avalon". 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time. Indefinite or set its RepeatCount property to 
double.Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
LengthAnimation. the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 
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<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="1 0" Stroke="Black"> 
<Line.X2> 

<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

II cn 

Line myLine = new LineQ; 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation. Duration = new Time(IOOOO); 
myLengthAnimation.RepeatDuration = Time.lndefinite; 

LengthAnimationColIection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnimations(Line.X2Property, collection); 
•VB.NET 

Dim myLine As new MSAvalon.Windows. Shapes. Line 

Dim myLengthAnimation As new MSAvalon.Windows.Media.Animation.LengthAnimation 
myLengthAnimation.From = new MSAvalon.Windows. Length{30) 
myLengthAnimation.To = new MSAvalon.Windows. Length(300) 
myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time(IOOOO) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimationCollectlon 
collection.Add(myLengthAnimation) 

myLine.SetAnlmations(Line.X2Property, collection) 



RectAnimationCollection Class 

Definition: Represents a collection of RectModifier animations. 



Method 



Add 

AddChild 
AddText 



Description 

The Add(RectModifier) and Add(Object) methods add animations to the 
collection. The Add(Rect, RectAnimationCollection) method calculates 
the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 
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Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 

Disable 
DfsablelmpI 



Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified RectModifier. 

Creates a copy of this RectAnimationCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire RectAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetVaiuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MembenviseClone 

ModifyHandlerlfChangeable 



Determines whether two Object instances are equal. Inherited from 

Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
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OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
Read Preamble 

RectAnimationCollection 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToStrIng 

ValidateObjectState 
WritePostscript 

WritePreamble 



method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Creates an empty RectAnimationCollection with a default capacity for a 
single animation. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 



AnimationType 

CanMakeUnchangeable 

Count 

CountlmpI 

Empty 

IsChangeable 

IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 



promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 

An unchangeable empty RectAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
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IsUsingBaseValuelmpI 
Item 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 



Item 



StatusOfNextUse 



SyncRoot 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as RectAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an RectAnimationCollection, the property 
calls the RectAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWldth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Width> 



A Button 
</Button> 
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In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnlmations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Lefl="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property — properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element — those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



RectKeyFrameCollection Class 



CloneDownToUnchangeable 

Copy 
Copy 



Method Description 

Add Strongly typed implementation of Add. 

CloneCore Implementation of CtoneCore. 

Returns an immutable copy of the specified object. Inherited from 

Changeable. 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a new RectKeyFrameCollection 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 



EmbeddedChangeableWriter 

Equals 
Finalize 
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GetCurrentSegmentValues 

GetHashCode 

GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
PropagateEventHandler 

Read Preamble 

RectKeyFrameCollection 
ReferenceEquals 

ToString 
Validate 

ValidateObjectState 
WritePostscript 

WritePreamble 



operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes It. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ui) context. This method should be called 
before any simple members are set. Inherited from Changeable, 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 
" determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

CanMakeUnchanaeable ^'^"^ ^^^^ Changeable can be made unchangeable. Inherited from 

^ Changeable. 

Count Implementation of Count 

Destination The value specified in the last KeyFrame. 

IsChangeable ^ Boolean that indicates whether the object Is currently 

^ modifiable. Inherited from Changeable. 

Item 
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Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
StatusOfNextUse *® considered used in the following situations: the object is set into a 

Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext ^^^^ UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 



RectModifier Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this RectModifier 

Retums a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
GetHashCode hashing algorithms and data structures like a hash table. Inherited from 

Object 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 
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OnChanged 
opjmplicit 

PropagateEventHandler 

Read Preamble 

RectModifier 
ReferenceEquals 
SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

implicitly creates an AnimationCollection from a RectModifier 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeabteHelper.UseChangeable. to help 
^ determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period- Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 

IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



RectTimedModlfier Class 
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Meth d 



Beginin 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



Descripti n 

Starts or restarts the animatior) at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this RectTimedModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a copy of this RectModifier Inherited from RectModifier. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
Enable ParentTimeline property. This allows the timeline to become active. This 

method throws an exception if the ParentTimeline property is null. 
Endin Schedules an interactive end time. 



EmbeddedChangeableWriter 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeabteCore 
MembenA^iseClone 

ModifyHandlerlfChangeable 

OnChanged 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from RectModifier. 
Inherited from RectModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeabteCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
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opjmplicit 
Pause 

PropagateEventHandler 

ReadPreamble 

RectTimedModifier 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a RectModifier Inherited 
from RectModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 
SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 
Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single fonward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
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Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 
Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



ShoitAntmationCollection Class 

Definition: Represents a collection of ShortModifier animations. 

Method Descrlpti n 

The Add(ShortModifier) and Add(Object) methods add animations to the 
Add collection; the Add(lnt16,ShortAnimationCoHection) method calculates 
the current value of the specified collection based on the specified base 
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AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 



value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified ShortModifier. 

Creates a copy of this ShortAnimationCollection. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Copies the entire ShortAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
Memben/viseClone 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 

from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
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ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ShortAnimationCollection 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Creates an empty ShortAnimationCollection with a default capacity for a 
single animation. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used In conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

^ determine when a Changeable being put into use should be 

promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 

CanMakeUnchangeable 

Count 
CountlmpI 
Empty 

IsChangeable 

IsChanging 
IsFixedSize 
IsOverridingBaseValue 



An unchangeable empty ShortAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Retums true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 
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IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 

Item 



StatusOfNextUse 



SyncRoot 
UlContext 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 

AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as ShortAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an ShortAnimationCollection, the property 
calls the ShortAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 



ShortModifier Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ShortModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
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GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandterlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 
ShortModifier 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a ShortModifier 

Shares a Changed event handler with the current object's data members 
or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f,^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into use ' should be 
promoted to "ChangeableReference". Inherited from Changeable. 

CanMakeUnchanaeable ^^^^ '^^^'^ Changeable can be made unchangeable. Inherited from 

^ Changeable. 

IsChanqeable ^ Boolean that indicates whether the object is currently 

^ modifiable. Inherited fi^om Changeable. 
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IsChanging 

IsOverridingBaseVatue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



ShortTimedModtfier Class 



Method 



Beginin 



CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 



Disable 



Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this ShortModifier Inherited from ShortModifier. 
Creates a copy of this ShortTimedModifier 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



EmbeddedChangeableWriter 



Enable 



Endin 
Equals 
FilllnClone 

Finalize 

GetHashCode 



Detemnines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by gariDage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
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GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ShortTimedModifier 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from ShortModifier. 
Inherited from ShortModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a ShortModifier Inherited 
from ShortModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeaWeHelper.UseChangeable. to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 
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AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTlmeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 



Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single fonvard iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that Indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 

Gets or sets the total length of time the animation should play. If this 

value is greater than the simple duration of the animation, it will 

repeat itself for the length time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 

is, how the animation behaves when a second begin time is 

reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
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Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline Timeline 

UlContext ^^^^ UlContext of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 
UsesBaseValue UsesBaseValue Inherited from Modifier. 



SizeAninnation Class 

Definition: Defines an animation based on the Size of an object. By providing Size infomnation, an object 
can appear to shrink or enlarge over a period of time. 



Beglnin 
CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 



Method Description 

Starts or restarts the animation at the specified offset from the current 
time. Inherited from SizeTimedModifier. 

Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this SizeTimedModifier Inherited from 
SizeTimedModifier. 

Creates a copy of this SizeModifier Inherited from SizeModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
Disable active. The timeline can be re-enabled with a call to Enable. Inherited 

from SizeTimedModifier. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from SizeTimedModifier. 



EmbeddedChangeableWriter 



Enable 



Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 



Schedules an interactive end time. Inherited from SizeTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from SizeTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
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GetValue 

GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTimeline 
SizeAnimation 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Calculates the current value of the animation from the specified base 
value. 

Inherited from SizeModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a SizeModifier Inherited 
from SizeModifier. 

Pauses this timeline. Inherited from SizeTimedModifier. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. Inherited from SizeTimedModifier. 

Moves the current position of the animation backwards or forwards from 

either the current time, the Begin time, or the End time. Inherited from 

SizeTimedModifier. 

Initializes a new instance of the SizeAnimation class. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Acceleration ^^^^ fraction of the simple duration spent in the 

acceleration phase. Inherited from SizeTimedModifier. 

Used in conjunction with the ChangeableUsageOvemde type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
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AutoReverse 

Begin 
By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 

IsAdditive 

IsChangeable 

IsChanging 

IsCumulative 
IsEnabled 

IsForwardProgressing 

IsOvenidingBaseValue 

IsPaused 

IsReversed 
KeyFrames 



Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its fonA/ard iteration. Inherited from 
SizeTimedModifier. 

Gets or sets an offset to the start time of the animation. Inherited 
from SizeTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from SizeTimedModifier. 

Gets the current time value of the animation. Inherited from 
SizeTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
SizeTimedModifier. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from SizeTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
SizeTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
SizeTimedModifier 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from SizeTimedModifier. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. Inherited 
from SizeTimedModifier. 

Gets or sets the starting value of an animation. 

Gets or sets a value that specifies how output values are calculated 
for the animation. 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from SizeTimedModifier. 

IsCumulative 

Inherited from SizeTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from SizeTimedModifier. 

Gets a value that indicates whether the animation Is active or in a fill 
period. Inherited from SizeTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from SizeTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
SizeTimedModifier. 

KeyValues 
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Gets or sets the default parent timeline of the animation. Inherited 
from SizeTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from SizeTimedModifier. 
Gets or sets the number of times an animation should 
repeat. Inherited from SizeTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is great than the simple duration of the animation, it will repeat 
itself until the time specified by this property. Inherited from 
SizeTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from SizeTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from SizeTimedModifier. 
Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
SizeTimedModifier 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Timeline Inherited from SizeTimedModifier. 

Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "Longhorn" markup language (code-named "XAML"), set the animation's 
RepeatDuration property to Indefinite. In code, set the animation's RepeatDuration property to 
Time.lndefinite or set its RepeatCount property to double.Positivelnfinity. 

In the following examples, a Length Animation is set to repeat indefinitely. Although this example uses a 
LengthAnimation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="10" Stroke="Black"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 



ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 

StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseValue 
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//c# 

Line myLine = new Line(): 

LengthAnimation myLengthAnimation = new LengthAnimation{); 
my Length Aninnation.Fronn = new Length(30); 
myLengthAnimation. To = new Length(300); 
myLengthAnimation. Duration = new Tlme(IOOOO); 
myLengthAnimation. RepeatDuration = Time. Indefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnimations{Line.X2Property, collection); 

'VB.NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon.Windows.Media.Animation.LengthAnimation 
myLengthAnimation. From = new MSAvalon. Windows. Length(30) 
myLengthAnimation.To = new MSAvalon. Windows. Length(300) 
myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time(IOOOO) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation. LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property. collection) 

The previous examples use classes from the MSAvalon.Windows.Media.Animation, MSAvalon.Windows, 
and MSAvalon.Windows.Shapes namespaces. 

This example demonstrates how to animate a property in code. To animate a property, you associate the 
proper animation collection and animations with the property, either directly or using the property's 
corresponding animation property. There are a variety of animation classes in the 
MSAvalon.Windows.Media. Animation namespace, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the Rectangle must be set to a non-animated value (in this 
case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. After 
the animation is created, it is applied to the button's Width property using the SetAnimations method. 
When using the SetAnimations property, you pass it the static property identifier field (in this example 
Button.WidthProperty) for the class and the AnimationCollection containing the animations. The code 
used to set the button's size and position has been omitted. 

//C# 

Button aButton = new Button(); 
// Animate the Button's Width. 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.To = new Length(50); 
myLengthAnimation. Duration = new Time(5000); 
myLengthAnimation.AutoReverse = true; 



522 



myLengthAnimation.RepeatDuration = Time.lndefinite; 
LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Acld(myLengthAmmation); 

// Set the animation. 

aButton.SetAnimations(Button.WjdthProperty, collection); 
'VB.NET 

Dim aButton As MSAvalon.Windows.Controls.Button 
aButton = new MSAvalon.Windows.Controis. Button 

MSAvalon.Windows.Controls.Canvas.SetLeft(aButton, new MSAvalon. Windows. Length(20)) 
MSAvalon.Windows.Controis. Canvas. SetTop(aButton, new MSAvalon. Windows. Length(20)) 
aButton. Width = new MSAvalon.Windows.Length(200) 
aButton. Height = new MSAvalon,Windows.Length(30) 
aButton.Content = "A Button" 

' Animate the Button's Width. 

Dim myLengthAnimation As MSAvalon. Windows.Media.Animation. Length Animation 
myLength Animation = new MSAvalon. Windows. Media. Animation. LengthAnimation 
myLengthAnimation. To = new MSAvalon.Windows.Length(50) 
myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time(5000) 
myLengthAnimation.AutoReverse = true 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As MSAvalon.Windows.Media.Animation. LengthAnimationCollection 
collection = new MSAvalon.Windows.Media.Animation. LengthAnimationCollection 
collection.Add(myLengthAnimation) 

aButton.SetAnimations(MSAvalon.Windows.Controls.Button.WidthProperty, _ 
collection) 

In the previous example, the starting value of the animation isn't specified, so the animation uses the 
value of the button's Width as its starting value. 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimationCollection and a ColorAnimation are used to animate the property. The Color property has 
a corresponding ColorAnimations property, so the ColorAnimation is added to the ColorAnimations 
property's ColorAnimationCollection using the Add method. 

II C# 

//Create and set the second Button. 
Button anotherButton = new Button(): 

// Create and animate a Brush to set the Button's 
// background. 

SolidColorBrush myBrush = new SolidColorBrush(); 
myBrush.Color = Colors. Blue; 

ColorAnimation myColorAnimation = new ColorAnimation(); 
myColorAnimation.From = Colors.Blue; 
myColorAnimation.To = Colors.Red; 
myColorAnimation. Duration = new Time(7000); 
myColorAnimation.AutoReverse = true; 
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myColorAnimation.RepeatDuration = Time. Indefinite; 

myBrush.ColorAnimations.Add(myColorAnimation); 
anotherButton. Background = myBrush; 



'VB.NET 
' Create and set the second Button. 
Dim anotherButton As iVISAvalon. Windows. Controls. Button 
anotherButton = new MSAvalon.Windows.Controls.Button 
Canvas.SetLeft(anotherButton, new MSAvalon, Windows. Length(20)) 
Canvas.SetTop(anotherButton, new MSAvalon. Windows. Length(70)) 
anotherButton. Width = new MSAvalon. Windows. Length(200) 
anotherButton. Height = new MSAvalon. Windows, Length(30) 
anotherButton.Content = "Another Button" 

' Create and animate a Brush to set the Button's fill. 
Dim myBrush As MSAvalon.Windows.Media.SolidColorBrush 
myBrush = new MSAvalon.Windows.Media.SolidColorBrush 
myBrush.Color = MSAvalon.Windows.Media.Colors.Blue 
Dim myColorAnimation As MSAvalon. Windows. Media. Animation.ColorAnimation 
myColorAnimation = new MSAvalon.Windows.Media.Animation.ColorAnimation 
myColorAnimation. From = MSAvalon.Windows.Media.Colors.Blue 
myColorAnimation.To = MSAvalon.Windows.Media.Colors.Red 
myColorAnimation. Duration = new MSAvalon. Windows.Media.Animation.Time(7000) 
myColorAnimation.AutoReverse = true 
myColorAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 
myBrush.ColorAnimations.Add(myColorAnimation) 
anotherButton. Background = myBrush 



This example uses the MSAvalon.Windows, MSAvalon. Windows. Controls, MSAvalon.Windows.Media, 
and MSAvalon.Windows.Media.Animation namespaces. For more infomiation about animating properties, 
see Animation in "Avalon". 

This example demonstrates how to animate a property using "XAML". To animate a property, you 
associate the proper animation collection and animations with the property either directly or using the 
property's corresponding animation property. There are a variety of animation classes, each of which 
animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Lefl="20" 
Height="30" Width="200"> 
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<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True'7> 
</LengthAnimationCollection> 
</Button.Wldth> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas. Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SoiidColorBrush> 
</Button.Background> 

Another Button 
</Button> 



In the previous example, the ColorAnimationCollection tag. <ColorAnlmationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 

SizeAnimationCollection Class 

Definition: Represents a collection of SizeModifier animations. 



</Canvas> 



Method 



Description 



AddChild 



Add 



The Add(SizeModifier) and Add(Object) methods add animations to the 
collection; the Add(Si2e,SizeAnimationCollection) method calculates the 
current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 



AddText 



Implementation of AddText. This is not implemented on this class. 
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Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 

Contains 
Copy 

Copy 

CopyTo 

Disable 
Disablelmpl 



Implementation of Apply. Applies an animation collection in markup to 
an element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified SizeModifier. 

Creates a copy of this SizeAnimationCollection. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property Is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Copies the entire SizeAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MembenA/iseClone 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

GetEnumerator Inherited from AnimationCollection. 

Retums an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates and returns the output of the animation collection. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Implementation of MakeUnchangeableCore. 

Creates a shallow copy of the current Object. Inherited from Object. 
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ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 

SetValuelmpI 

SizeAnimationCollection 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Initializes a new instance of the SizeAnimationCollection class. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
Gets the type of animation stored in the collection. 
SizeAnimationCollection objects always return the type of 
SizeAnimation. 



AnimationType 



CanMakeUnchangeable 

Count 

CountlmpI 

Empty 

IsChangeable 

IsChanging 
IsFixedSize 
IsOverridingBaseValue 



True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 

An unchangeable empty SizeAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 
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IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 



Gets or sets the animation at the specified index. 

Use this to get or set a Modifier at a given index. Inherited from 

AnimationColIection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 



Inherited from AnimationColIection. 



Item 



StatusOfNextUse 



SyncRoot 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationColIection classes, such as SizeAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationColIection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of a SizeAnimationCollection, the property calls 
the SizeAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse='True'7> 
</LengthAnimationCollection> 
</Button.Width> 
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A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush. Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To=*'Blue" Duratlon="7" 
RepeatCount="500" AutoReverse="True7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property — properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 

This example demonstrates how to animate a property in code. To animate a property, you associate the 
proper animation collection and animations with the property, either directly or using the property's 
corresponding animation property. There are a variety of animation classes in the 
MSAvalon. Windows. Media. Animation namespace, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the Rectangle must be set to a non-animated value (in this 
case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. After 
the animation is created, it is applied to the button's Width property using the SetAnimations method. 
When using the SetAnimations property, you pass it the static property identifier field (in this example 
Button.WidthProperty) for the class and the AnimationCollection containing the animations. The code 
used to set the button's size and position has been omitted. 

//C# 

Button aButton = new Button(); 
// Animate the Button's Width. 
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LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimationTo = new Length(50); 
myLengthAnimation. Duration = new Time(5000); 
myLengthAnlmation.AutoReverse = true; 
myLengthAnimation. RepeatDuration = TimeJndefinite; 
LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Aclcl(myLengthAnimation); 

// Set the animation. 

aButton.SetAnimations(Button.WidthProperty, collection); 
'VB.NET 

Dim aButton As MSAvalon.Windows.Controls.Button 
aButton = new MSAvalon.Windows.Controls.Button 

MSAvalon.Windows.Controls.Canvas.SetLeft(aButton, new MSAvalon. Windows. Length{20)) 
MSAvalon.Windows.Controls.Canvas.SetTop(aButton, new MSAvalon. Windows. Length(20)) 
aButton.Width = new MSAvalon.Windows.Length(200) 
aButton. Height = new MSAvalon. Windows. Length(30) 
aButton.Content = "A Button" 

' Animate the Button's Width. 

Dim myLengthAnimation As MSAvalon.Windows.Media.Animation.LengthAnimation 
myLengthAnimation = new MSAvalon.Windows.Media.Animation.LengthAnimation 
myLengthAnimation.To = new MSA valon. Windows. Length(50) 
myLengthAnimation. Duration = new MSAvalon. Windows.Media.Animation.Time(5000) 
myLengthAnlmation.AutoReverse = true 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As MSAvalon.Windows.Media.Animation. LengthAnimationCollection 
collection = new MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection.Add(myLengthAnimation) 

aButton, SetAnimations(MSAvalon.Windows.Controls.Button.WidthProperty, _ 
collection) 

In the previous example, the starting value of the animation isn't specified, so the animation uses the 
value of the button's Width as its starting value. 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimationCollection and a ColorAnimatlon are used to animate the property. The Color property has 
a corresponding ColorAnimations property, so the ColorAnimatlon is added to the ColorAnimations 
property's ColorAnimationCollection using the Add method. 

//C# 

//Create and set the second Button. 
Button anotherButton = new ButtonQ; 

// Create and animate a Brush to set the Button's 
// background. 

SolidColorBrush myBrush = new SolidColorBrush(); 
myBrush.Color = Colors. Blue; 

ColorAnimatlon myColorAnimation = new ColorAnimation(); 



530 



myColorAnimation.From = Colors. Blue; 
myColorAnimation.To = Colors.Red; 
myColorAnimation. Duration = new Time(7000); 
myColorAnimation.AutoRe verse = true; 
myColorAnimation. RepeatDuration = Time.lndefinite; 

myBrush.ColorAnimations.Add(myColorAnjmation); 
anotherButton. Background = my Brush; 



'VB.NET 
' Create and set the second Button. 
Dim anotherButton As MSAvalon.Windows.Controls. Button 
anotherButton = new MSAvalon.Windows.Controls.Button 
Canvas.SetLeft(anotherButton, new l\/ISAvalon.Windows.Length(20)) 
Canvas.SetTop{anotherButton, new MSAvalon. Windows. Length(70)) 
anotherButton.Width = new MSAvalon. Windows.Length(200) 
anotherButton. Height = new MSAvalon. Windows. Length(30) 
anotherButton.Content = "Another Button" 

' Create and animate a Brush to set the Button's fill. 
Dim myBnjsh As MSAvalon.Windows.Media.SolidColorBrush 
myBrush = new MSAvalon. Windows. Media.SolidColorBrush 
myBrush. Color = MSAvalon.Windows.Media.Colors.Blue 
Dim myColorAnimation As MSAvalon, Windows. Media. Animation. ColorAnimation 
myColorAnimation = new MSAvalon.Windows.Media.Animation.ColorAnimation 
myColorAnimation.From = MSAvaion.Windows. Media. Colors. Blue 
myColorAnimation.To = MSAvalon. Windows.Media.Colors.Red 
myColorAnimation. Duration = new MSAvalon. Windows.Media.Animation.Time(7000) 
myColorAnimation.AutoReverse = true 
myColorAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 
myBrush. ColorAnimations.Add(myColorAnimation) 
anotherButton. Background = myBrush 



SizeKeyFrameCollection Class 



Method Description 

Add Strongly typed implementation of Add. 

CloneCore Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a new SizeKeyFrameCollection 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 



CloneDownToUnchangeable 
Copy 

Copy 



EmbeddedChangeableWriter 
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Equals 
Finalize 

GetCurrentSegmentValues 

GetHashCode 

GetType 

MakeUnchangeable 

l\1akeUnchangeableCore 
l\1emberwiseClone 

ModifyHandlerlfChangeable 
OnChanged 

PropagateEventHandler 

Read Preamble 

ReferenceEquals 

SizeKeyFrameCollection 

ToString 

Validate 

ValidateObjectState 
WritePostscript 

WritePreamble 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

TODO 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Implementation of Count. 

The value specified in the last KeyFrame. 



CanMakeUnchangeable 

Count 
Destination 
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IsChangeable 
Item 

StatusOfNextUse 
UlContext 



Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable, 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawlngContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



SizeModifier Class 



CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable, 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this SizeModifier 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 

Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 
GetHashCode 



GetType 
GetValue 
GetValuelmpI 
IModlfier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 

MemberwiseClone 

ModifyHandlerlfChangeable 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
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OnChanged 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 
SizeModlfier 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable object, if the object is currently modifiable. If the specified 

object is not modifiable— if its IsChangeable property is false— this 

method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 

Changed should call this method after they have been 

modified. Inherited from Changeable. 

Implicitly creates an AnImationCollection from a SizeModifier 
Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
Instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride !® ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOvemdingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 
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SizeTimedM difier Class 



Method 



Beginin 



CloneCore 

CloneDownToUnchangeable 

Copy 
Copy 

Copy 
Disable 



Descripti n 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Retums an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this SizeModifier Inherited from SizeModifier. 

Creates a copy of this SizeTimedModifier 

Retums a modifiable copy of the current object. The cop/s 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 
Schedules an interactive end time. 



EmbeddedChangeableWriter 



Enable 



Endin 
Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



Detemnines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from SizeModifier. 
Inherited from SizeModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 



535 



OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
SizeTimedModifier 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



object is not modifiable — if its IsChangeable property is false — ^thls 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a SizeModifier Inherited 
from SizeModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable, 

Determines whether the specified Object instances are the same 
Instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the cunrent Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object Is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the cunrent object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Acceleration 



Property Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeabteHelper.UseChangeable, to help 

determine when a Changeable being put into use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward Iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. 

Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. 



AutoReverse 
Begin 

CanMakeUnchangeable 

Cun^entRepeat 
CurrentTime 

Deceleration 
Duration 



536 



End 

EndSync 
Fill 

FillDefauit 

IsChangeable 

isChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 

Gets or sets the total length of time the animation should play. If this 
value is great than the simple duration of the animation, it will repeat 
itself until the time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



StringAnimationCollecti n Class 

Definition: Represents a collection of StringModifier animations. 



Method 



Descripti n 
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Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 



The Add(StringModifier) and Add(Object) methods add animations to the 
collection; the Add(String,StringAnimationCollection) method calculates 
the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Retums a Boolean that indicates whether the collection contains the 
specified StringModifier. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this StringAnimationCollection. 

Copies the entire StringAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IndexOf 

Insert 

MakeUnchangeable 



Determines whether two Object instances are equal. Inherited from 

Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 



Makes an object immutable; after this method is called on a Changeable, 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

StringAnimationCollection 
ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



its IsChangeable property is false. Inherited from Changeable, 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Creates an empty StringAnimationCollection with a default capacity for a 
single animation. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent In 
AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable bemg put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Inherited from AnimationCollection. 



AnimationType 

CanMakeUnchangeable 

Count 
CountlmpI 
Empty 

IsChangeable 
IsChanging 



An unchangeable empty StringAnimationCollection. 

Gets a Boolean that indicates whether the object is currently 

modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 
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IsFixedSize 



IsOverridingBaseValue 

IsReadOnly 

IsSynchronized 

IsUsingBaseValue 

IsUsingBaseValuelmpI 

Item 



Returns true if at least one of the animations in the animation list is 
currently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 



Item 



this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 



StatusOfNextUse 



Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used In a 
DrawingContext command. Inherited from Changeable. 



SyncRoot 



UlContext 



Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



The AnimationCollection classes, such as StringAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of an StringAnimationCollection, the property 
calls the StringAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the propert/s corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
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AutoReverse="True"/> 
</LengthAnimationCollection> 
</Button.Wiclth> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button CanvasTop="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True'7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag, <ColorAnlmationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property — properties of the form 
PropertyNameAnimatlons, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 



StringModifier Class 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 

Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Copy Creates a copy of this StringModifier 

Accesses the specified Changeable data member, processes it. and 
EmbeddedChangeableReader returns a reference to the member. This reference should then be 
^ reassigned to the original member variable. Classes that derive from 



CloneDownToUnchangeable 



Copy 
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EmbeddedChangeableWriter 
Equals 

Finalize 



GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 
opjmplicit 

PropagateEventHandler 
Read Preamble 

ReferenceEquals 

SetDefaultParentTlmeiine 
StringModlfier 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a StringModifier 

Shares a Changed event handler with the current object's data members 
or removes it Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTlmeiine Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Descripti n 
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Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChanqeableReferenceOverride ®^ ® parameter to ChangeableHelper.UseChangeable, to help 
^ detennine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOverridingBaseValue 

StatusOfNextUse 

UlContext 
UsesBaseValue 



Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
Is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

UsesBaseValue Inherited from Modifier. 



StringlimedModifier Class 



Method Description 

Starts or restarts the animation at the specified offset from the current 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this StringTimedModifier 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this StringModifier Inherited from StringModifier. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is null. 



Beginin 
CloneCore 

CloneDownToUnchangeable 
Copy 

Copy 

Copy 
Disable 



EmbeddedChangeableWriter 



Enable 
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Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 
GetValue 
GetValuelmpI 
IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquais 

Resume 

Seek 

SetDefaultParentTimeline 

StringTimedModifier 

ToString 

ValidateObjectState 
WiitePostscript 

WritePreamble 



Schedules an interactive end time. 

Detemnines whether two Object instances are equal. Inherited from 
Object 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Sen/es as a hash function for a particular type, suitable for use In hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 

Inherited from StringModifier. 

Inherited from StringModifier. 

Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
Its IsChangeable property is false. Inherited from Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false— this method 
has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a StringModifier Inherited 
from StringModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid user interface (Ul) context. This method should be called before 
any simple members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from Changeable. 
Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed from 
a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property 



Description 
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Acceleration 

AllowChangeableReferenceOverride 

AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsFonwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 
RestartDefault 



Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
as a parameter to ChangeableHelperUseChangeable, to help 
determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. 

Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 

Changeable. 

Gets the number of the current iteration of the animation. 
Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 

duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 

single forward iteration, also known as the simple duration of an 

animation. 

Gets or sets the maximum end time of the animation. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is detemnined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 

period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is cunrently 
moving in the opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the current 
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Speed 

StatusOfNextUse 

Timeline 

UlContext 

UsesBaseValue 



animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
UsesBaseValue Inherited from Modifier. 



Timeline Class 

Definition: Maintains run-time timing state for timed objects. 



lUlethod 

BeginIn 
CloneCore 

CloneDownToUnchangeable 



Copy 
Disable 

DisableChildren 
EmbeddedChangeableReader 

EmbeddedChangeableWriter 

Enable 
Endin 
Equals 

Finalize 

GetEnumerator 
GetHashCode 
GetType 

MakeUnchangeable 



Description 

Schedules a begin for some specified time in the future. 
Clones this timeline. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Disables this timeline by disconnecting it from its current parent timeline. 
Disables the children of this timeline. 

Accesses the specified Changeable data member, processes It, and 
returns a reference to the member. This reference should then be 
reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Enables this timeline by connecting it to its specified parent timeline. 
Auto-parented timelines can't be enabled with this method. 
Schedules an end for some specified time in the future. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Retums an enumerator for the children of this container. 
Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

Makes an object immutable; after this method is called on a Changeable, 

its IsChangeable property is false. Inherited firom Changeable. 
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MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

Timeline 

ToString 

ValidateObjectState 
WritePostscript 

WritePreamble 



Called by the Changeable base class to ask the Timeline to make itself 
unchangeable. 

Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Pauses the timeline for this timeline and its children. 

Called by the Changeable base class whenever the Changed event is 
hooked or unhooked. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Allows a timeline's timeline to progress again after a call to Pause. 

Seeks a timeline's timeline to a new position. 

Creates a timeline with all timing attributes set to their default values. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Acceleration 



Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 



AllowChangeableReferenceOverride f Parameter to ChangeableHelper.UseChangeable, to help 

detemnine when a Changeable being put into use" should be 



AutoReverse 
Begin 

CanMakeUnchangeable 

CurrentRepeat 
CurrentTime 

Deceleration 

Duration 



promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the timeline plays in 
reverse after it completes its forward iteration. 

Specifies the begin time for this timeline, in milliseconds. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

The current repeat period. The first period has a value of one. 

Gets the current position of the timeline, relative to the start time. 

Specifies the percentage of a simple duration that is spent in the 
time deceleration phase. 

Gets or sets the length of time the timeline takes to complete a 



547 



End 

EndSync 
Fill 

FillDefault 

HasChanged 

IsAlive 

IsChangeable 

IsChanging 
IsEnabted 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimellne 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Root 
Speed 



StatusOfNextUse 



UlContext 



single fonA^ard iteration, also known as the simple duration of an 

timeline. 

Specifies the maximum end time for this timeline, in milliseconds. 
Defines how this container calculates its implicit duration. 
The fill attribute for this timeline. 

The default for the fill attribute for this timeline and its children. 

Returns true if the timeline has changed since the last Tick. 

True if the timeline can be started, false otherwise. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

True if the timeline is currently active, false otherwise. 

True if the timeline participates in a timing tree, false othenA/ise. 

True if real time flows fonward in this timeline. 

True if the timeline is active or if it is past an active period but the fill 

attribute specifies that the state of the timeline should be preserved. 

True if the timeline is currently paused, false otherwise. 

True if this timeline is currently reversed, false othenvise. 

Returns the intended parent timeline for the Timeline. 

The current progress of time for this timeline. 

Gets or sets the number of times a timeline should repeat. 

Gets or sets the total length of time a timeline should play. If this 
value is great than the simple duration of the timeline, it repeats 
itself until the time specified by this property. 

Specifies the behavior of the timeline when a begin time is 
encountered after the first one (in any given activation period for the 
timeline's parent container). 

The default value for the Restart attribute for this timeline and its 
children. 

Returns the root timeline for the cunrent UlContext. 

Specifies the speed at which time runs in this timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



A timeline is used by animations and media to This class and its derived classes provide constructors that 
can be used to create timing objects. However, a timing object cannot be active until it is associated with 
a time manager. There are two ways to do this: by adding a timeline as a child of a time manager, or by 
adding a timeline to a container that is associated with a time manager. 



TinfielineBuilder Class 

Definition: An object that can be used to create Timeline objects. 



Meth d 



Descripti n 
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Clear 

Createlnstance 
Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 

ReferenceEquals 

TimelineBuilder 
ToString 

ToTimeline 



Clears all properties previously set on this builder, so that the builder is reset to 
the same state it is at when it's first created. 

Creates a Timeline object that has the attributes currently set on this builder. 
Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Creates a new TimelineBuilder object. 

Returns a String that represents the current Object. Inherited from Object. 
Creates a Timeline object that has the attributes cun^ently set on this builder. 



Property 


Description 


Acceleration 


Accesses the Acceleration SMIL attribute. 


AutoReverse 


Accesses the AutoReverse SMIL attribute. 


Begin 


Accesses the Begin SMIL attribute. 


Deceleration 


Accesses the Deceleration SMIL attribute. 


Duration 


Accesses the Duration SMIL attribute. 


End 


Accesses the End SMIL attribute. 


EndSync 


Accesses the EndSync SMIL attribute. 


Fill 


Accesses the Fill SMIL attribute. 


FillDefault 


Accesses the FillDefault SMIL attribute. 


ParentTimeline 




RepeatCount 


Accesses the RepeatCount SMIL attribute. 


RepeatDuration 


Accesses the RepeatDuration SMIL attribute. 


Restart 


Accesses the Restart SMIL attribute. 


RestartDefault 


Accesses the RestartDefault SMIL attribute. 


Speed 


Accesses the Speed SMIL attribute. 



TimelineBuilder objects are not thread-safe. The caller is responsible for ensuring that simultaneous 
access to a single TimelineBuilder object from two different threads does not occur. 



TinneManager Class 

Definition: The object that controls an entire timing tree. 



Method Description 

Equals Determines whether two Object instances are equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup 
Finalize operations before the Object is reclaimed by garbage collection. Inherited from 

Object. 

GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 
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algorithms and data staictures like a hash table. Inherited fronn Object. 



GetType 

MembenviseClone 

ReferenceEquals 

Restart 
SetContext 
Start 
Stop 

Tick 

TimeManager 
ToString 



Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resets the time manager and sets a new start time. 

Associates this UlContextObject with a UlContext. Inherited from UlContextObject. 
Starts the time manager at the current time. 
Stops the timeline. 

Moves the timeline fonward to the current time and updates the state of all timing 
objects based on the time change. 

Creates a time manager object in the stopped state. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

Clock 

Context 



CurrentTime 
IsDirty 

RootTimeline 



Description 

Accesses the reference clock used by this time manager to obtain real-worid clock values. 

Returns the UlContext that this UlContextObject is associated with. Inherited from 
UlContextObject. 

The current position of the timeline, relative to the starting time. Setting this property to a 
new value has the effect of seeking the timing tree to a new point in time. Both forward and 
backward seeks are allowed. Setting this property has no effect if the timeline is stopped. 
However, seeking while the timeline is paused works as expected. 

True if the structure of the timing tree has changed since the last tick. 

Returns the time container that is the root of the timing tree managed by this time manager. 



A time manager controls the flow of time in a timing tree. The timeline is updated periodically by the 
rendering system, at which time the progress value of all active timelines is updated according to the 
elapsed time. This elapsed time can be controlled by the application by specifying a custom reference 
clock in the constructor. 



TimeSyncValueTypeConverter Class 

Definition: An object that performs type conversions involving TimeSyncValue values. 



Method 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ConvertFrom 
ConvertFrom 

ConvertFrom I nvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 



Description 

Inherited from TypeConverter. 

Determines whether it is possible to convert an object of a given type into 
a TimeSyncValue value. 

Inherited from TypeConverter. 

Determines whether it is possible to convert a TimeSyncValue value into 
an object of a given type. 

Converts an object into a TimeSyncValue value. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Converts a TimeSyncValue value into an object of a different type. 
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ConvertTolnvariantString 

ConvertToString 

Createlnstance 

Equals 
Finalize 

GetConvertFromException 

GetConvertToExceptlon 

GetCreatelnstanceSupported 

GetHashCode 

GetProperties 
GetPropertiesSupported 

GetStandardValues 

GetStandardVaiuesExciusive 

GetStandardValuesSupported 

GetType 

IsValid 

MemberwiseClone 

ReferenceEquals 

SortProperties 

TimeSyncValueTypeConverter 
ToString 



Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Inherited from TypeConverter. 

Inherited from TypeConverter. 

Inherited from TypeConverter 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures Wke a hash table. Inherited from 
Object. 

Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter. 

Returns a String that represents the current Object. Inherited from 
Object. 



TimeTypeConverter Class 

Definition: An object that perfomris type conversions involving Time values. 



Method 

CanConvertFrom 

CanConvertFrom 

CanConvertTo 

CanConvertTo 

ConvertFrom 
ConvertFrom 

ConvertFromlnvariantString 

ConvertFromString 

ConvertTo 

ConvertTo 

ConvertTolnvariantString 



Description 

Inherited from TypeConverter. 

Determines whether it is possible to convert an object of a given type into 
a Time value. 

Inherited from TypeConverter. 

Determines whether it is possible to convert a Time value into an object 
of a given type. 

Converts an object into a Time value. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 
Inherited from TypeConverter. 

Inherited from TypeConverter. 

Converts a Time value into an object of a different type. 
Inherited from TypeConverter. 
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ConvertToString 
Createlnstance 

Equals 
Finalize 

GetConvertFromException 
GetConvertToException 
GetCreatelnstanceSupported 

GetHashCode 

GetProperties 
GetPropertiesSup ported 
GetStandardValues 
GetStandardValuesExclusive 
GetStandardValuesSupported 
GetType 
IsValid 

MembenviseClone 

ReferenceEquals 

SortProperties 
TimeTypeConverter 
ToString 



Inherited from TypeConverter 
Inherited from TypeConverter 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Inherited from TypeConverter 
Inherited from TypeConverter 
Inherited from TypeConverter. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 

Inherited from TypeConverter 

Inherited from TypeConverter 

Inherited from TypeConverter 

Inherited from TypeConverter 

Inherited from TypeConverter 

Gets the Type of the current instance. Inherited from Object. 
Inherited from TypeConverter 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Inherited from TypeConverter 

Returns a String that represents the current Object. Inherited from Object 



VectorAnimation Class 



Method Description 

Starts or restarts the animation at the specified offset from the current 
time. Inherited from VectorTlmedModifier 
Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this VectorTimedModifier Inherited from 
VectorTlmedModifier 

Creates a copy of this VectorModifier Inherited from VectorModifier. 
Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable, inherited 
from VectorTimedModifier 

Accesses the specified Changeable data member, processes it, and 
EmbeddedChangeableReader ^ reference to the member This reference should then be 

reassigned to the original member variable. Classes that derive from 
Changeable call this method on data members before they can be 



Beginin 
CloneCore 

CloneDownToU nchangeable 

Copy 
Copy 

Copy 



Disable 
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EmbeddedChangeableWriter 

Enable 

Endin 

Equals 

FilllnClone 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 
Resume 

Seek 

SetDefaultParentTlmellne 
ToString 

ValidateObjectState 



retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable, 

Enables this timeline, parenting it to the timeline specified by the 
ParentTimeline property. This allows the timeline to become active. This 
method throws an exception if the ParentTimeline property is 
null. Inherited from VectorTimedModifier. 

Schedules an interactive end time. Inherited from VectorTimedModifier. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Inherited from VectorTimedModifier. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Calculates the value of the animation at the current time. 

Inherited from VectorModifier. 

Inherited from Modifier. 

Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is false. Inherited from Changeable. 

MakeUnchangeableCore Inherited from Modifier 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been modified. Inherited 
from Changeable. 

Implicitly creates an AnimationCollection from a VectorModifier Inherited 
from VectorModifier. 

Pauses this timeline. Inherited from VectorTimedModifier. 
PropagateEventHandler 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 

Resumes this timeline. Inherited from VectorTimedModifier. 

Moves the current position of the animation backwards or forwards from 
either the current time, the Begin time, or the End time. Inherited from 
VectorTimedModifier. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
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VectorAnimation 
WritePostscript 

WritePreamble 



invalid state, this method throws an exception. Inherited fronn 
Changeable. 

Initializes a new instance of the VectorAnimation class. 

Causes the cun^ent object to validate Itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Acceleration 



Property Description 

Gets or sets the fraction of the simple duration spent in the 
acceleration phase. Inherited from VectorTimedModifier. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride f P^.^a^^eter to ChangeaWeHelper UseChangeable, to help 
^ determine when a Changeable being put into "use" should be 

promoted to "ChangeableReference". Inherited from Changeable. 
Gets or sets a value that indicates whether the animation plays in 
reverse after it completes its forward iteration. Inherited from 
VectorTimedModifier. 



AutoReverse 

Begin 
By 

CanMakeUnchangeable 

CurrentRepeat 

CurrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 
From 

InterpolationMethod 

IsAdditive 

IsChangeable 



Gets or sets an offset to the start time of the animation. Inherited 
from VectorTimedModifier. 

Gets or sets the total amount by which the animation changes its 
starting value. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets the number of the current iteration of the animation. Inherited 
from VectorTimedModifier. 

Gets the current time value of the animation. Inherited from 

VectorTimedModifier. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. Inherited from 
VectorTimedModifier. 

Gets or sets the length of time the animation takes to complete a 
single forward iteration, also known as the simple duration of an 
animation. Inherited from VectorTimedModifier. 

Gets or sets the maximum end time of the animation. Inherited from 
VectorTimedModifier. 

Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. Inherited from 
VectorTimedModifier. 

Gets or sets a value that specifies the state of an object when its 
animation ends. Inherited from VectorTimedModifier. 

Gets or sets a value that indicates the default value of the Fill 
property of the current animation and Its child timelines. Inherited 
from VectorTimedModifier. 

Gets or sets the starting value of an animation. 

InterpolationMethod 

IsAdditive 

Gets a Boolean that indicates whether the object is currently 
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IsChangtng 

IsCumulative 
IsEnabled 

IsForward Progressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

KeyFrames 
ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 

StatusOfNextUse 

Timeline 
To 

UlContext 
UsesBaseVatue 



modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from VectorTimedModifier. 

IsCumulative 

Inherited from VectorTimedModifier. 

Gets a value that indicates whether the animation is progressing 
from past to future. Inherited from VectorTimedModifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from VectorTimedModifier. 

Gets a value that indicates whether the animation is active and 
paused. Inherited from VectorTimedModifier. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. Inherited from 
VectorTimedModifier. 

KeyValues 

Gets or sets the default parent timeline of the animation. Inherited 
from VectorTimedModifier. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. Inherited from VectorTimedModifier. 

Gets or sets the number of times an animation should 
repeat. Inherited from VectorTimedModifier. 

Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this 
property. Inherited from VectorTimedModifier. 

Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. Inherited from VectorTimedModifier. 

Gets or sets the default value of the Restart property of the current 
animation and its child timelines. Inherited from 
VectorTimedModifier. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. Inherited from 
VectorTimedModifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Timeline Inherited from VectorTimedModifier. 

Gets or sets the ending value of the animation. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 
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Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimatlons 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xamr'> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Width> 
<LengthAnimationCollection> 
<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True'7> 
</LengthAnimationCollection> 
</Button.Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property in order 
to animate the color of the brush. 

<Button Canvas.Top="70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button.Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush,ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True"/> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Button.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCoilection tag, <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property — properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
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the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from U I Element— you must nest the animations within an animation collection tag. 

This example demonstrates how to create an animation that repeats indefinitely. To make an animation 
repeat indefinitely in "XAML", set the animation's RepeatDuration property to Indefinite. In code, set the 
animation's RepeatDuration property to Time.lndefinite or set its RepeatCount property to 
double.Positivelnfinity. 

In the following examples, a LengthAnimation is set to repeat indefinitely. Although this example uses a 
Length Animation, the procedure is the same for all the animation classes. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Line X1="10" Y1="20" X2="50" Y2="20" 
StrokeThickness="10" Stroke="Black"> 
<Line.X2> 
<LengthAnimationCollection> 
<LengthAnimation From="30" To="300" Duration="10" 
RepeatDuration="lndefinite" /> 
</LengthAnimationCollection> 
</Line.X2> 
</Line> 

</Canvas> 

lie* 

Line myLine = new Llne(); 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.From = new Length(30); 
myLengthAnimation.To = new Length(300); 
myLengthAnimation. Duration = new Time(IOOOO); 
myLengthAnimation.RepeatDuration = Time.lndefinite; 

LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

myLine.SetAnlmations(Line.X2Property, collection); 

' VB .NET 

Dim myLine As new MSAvalon.Windows.Shapes.Line 

Dim myLengthAnimation As new MSAvalon.Windows.Media.Animation.LengthAnimation 
myLengthAnimation.From = new MSAvalon. Windows. Length(30) 
myLengthAnimation.To = new MSAvalon. Windows. Length(300) 
myLengthAnimation. Duration = new MSAvalon.Wlndows.Media.Animation.Time(IOOOO) 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 

Dim collection As new MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection.Add(myLengthAnimation) 

myLine.SetAnimations(Line.X2Property, collection) 
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Vect rAnimati nC llection Class 

Definition: Represents a collection of VectorModifier animations. 



Meth d 

Add 

AddChild 

AddText 

Apply 

Clear 
CloneCore 

CloneDownToUnchangeable 
Contains 

Copy 

Copy 

CopyTo 

Disable 
DisablelmpI 



Description 

The Add(VectorModifier) and Add(Object) methods add animations to the 
collection; the Add{Vector,VectorAnimationCollection) method calculates 
the current value of the specified collection based on the specified base 
value. 

Implementation of AddChild. Adds a Modifier to this AnimationCollection 
from Markup. 

Implementation of AddText. This is not implemented on this class. 

Implementation of Apply. Applies an animation collection in markup to an 
element. 

Clears the collection by setting the collection's Count to 0. 
CloneCore 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a Boolean that indicates whether the collection contains the 
specified VectorModifier. 

Returns a modifiable copy of the current object. The copy's IsChangeable 
property is true and its StatusOfNextUse is Unchangeable. Inherited from 
Changeable. 

Creates a copy of this VectorAnimationCollection. 
Copies the entire VectorAnimationCollection to the specified one- 
dimensional array, starting at the specified index of the target array. 
Inherited from AnimationCollection. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 
Inherited from AnimationCollection. 



EmbeddedChangeableWriter 

Enable 
EnablelmpI 

Equals 
Finalize 

GetEnumerator 
GetEnumeratorlmpI 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

GetEnumerator Inherited from AnimationCollection. 

Returns an object that can be used to enumerate items in the list. 

Serves as a hash function for a particular type, suitable for use in 

hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 
Returns the current value of the animation. 
Provides a Modifier at a given index. 
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IndexOf 
Insert 

MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 



ModifyHandlerlfChangeable 

OnChanged 
op_Addition 
opjmplicit 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Remove 
RemoveAt 

SetDefaultParentTimeline 
SetValuelmpI 

ToString 

ValidateObjectState 

VectorAnimationCollection 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a Changeable, 
its IsChangeable property is felse. Inherited from Changeable. 
Implementation of MakeUnchangeableCore. 
Creates a shallow copy of the current Object. Inherited from Object 
Adds or removes a Changed event handler to or from the specified 
Changeable object, If the object is cunrently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 
OnChanged 



Implementation of PropagateEventHandler. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 



Inherited from AnimationCollection. 
Sets a Modifier at a given index. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Creates an empty VectorAnimationCollection with a default capacity for a 
single animation. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property 



Description 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable. to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 
AnimationType AnimationType 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Count Inherited from AnimationCollection. 

CountlmpI 

Empty An unchangeable empty VectorAnimationCollection. 

IsChangeable Gets a Boolean that indicates whether the object is currently 



CanMakeUnchangeable 
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modifiable. Inherited from Changeable. 

Returns true if at least one of the animations in the animation list is 
currently active. Inherited from AnimationCollection. 

Returns true if at least one of the animations in the animation list is 
cun^ently on. Inherited from AnimationCollection. 



Inherited from AnimationCollection. 
this - typed version of indexer 

Use this to get or set a Modifier at a given index. Inherited from 
AnimationCollection. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 

The AnimationCollection classes, such as VectorAnimationCollection, provide you with more control over 
how you animate a property than a single animation could. Each of the AnimationCollection classes 
effectively functions as a single composite animation, using all the animations in the collection to animate 
a base value. When a property requests the current value of a VectorAnimationCollection. the property 
calls the VectorAnimationCollection's GetValue method and passes it the property's base value. The first 
animation in the collection processes this base value and produces a result, which is then passed to the 
next animation in the collection, and so on, until the value has been processed by all the animations in the 
collection. 

This example demonstrates how to animate a property using "Longhorn" markup language (code-named 
"XAML"). To animate a property, you associate the proper animation collection and animations with the 
property either directly or using the property's corresponding animation property. There are a variety of 
animation classes, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the RectangleWidth must be set to a non-animated value 
(in this case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. 
Although in this example there is only one animation, you could associate multiple animations with a 
single property by placing the animations within the collection. Because there is no WidthAnimations 
property, the LengthAnimationCollection is associated directly with the button's Width property. 

<Canvas ID="root" 
xmlns="http://schemas.microsoft.com/2003/xaml"> 

<Button Canvas.Top="20" Canvas. Left="20" 
Height="30" Width="200"> 



IsChanging 

IsFixedSize 

IsOverridingBaseValue 

IsReadOnly 
IsSynchronized 
IsUsingBaseValue 
IsUsingBaseValuelmpI 
Item 

Item 

StatusOfNextUse 

SyncRoot 
UlContext 
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<Button.Width> 
<LengthAnimationCollection> 

<LengthAnimation To="50" Duration="5" RepeatCount="500" 
AutoReverse="True'7> 
</LengthAnimationCollection> 
</Button,Width> 

A Button 
</Button> 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush.Color property accepts a Color, a 
ColorAnimation is used to animate the property. The SolidColorBrush.Color property has a corresponding 
ColorAnimations property, so the ColorAnimation is nested within the ColorAnimations property In order 
to animate the color of the brush. 

<Button Canvas.Top='70" Canvas. Left="20" 
Height="30" Width="200"> 

<Button. Background> 
<SolidColorBrush Color="Blue"> 
<SolidColorBrush.ColorAnimations> 
<ColorAnimation From="Red" To="Blue" Duration="7" 
RepeatCount="500" AutoReverse="True'7> 
</SolidColorBrush.ColorAnimations> 
</SolidColorBrush> 
</Butlon.Background> 

Another Button 
</Button> 

</Canvas> 

In the previous example, the ColorAnimationCollection tag. <ColorAnimationCollection>, is omitted when 
animating the brush's color. When animating a designated animation property— properties of the form 
PropertyNameAnimations, such as the ColorAnimations property in the previous example — you may omit 
the animation collection tag. However, when animating a property of a Ul element— those classes that 
derive from UlElement— you must nest the animations within an animation collection tag. 
For more information about animating properties, see Animation in "Avalon". 

This example demonstrates how to animate a property in code. To animate a property, you associate the 
proper animation collection and animations with the property, either directly or using the propert/s 
corresponding animation property. There are a variety of animation classes in the 
MSAvalon. Windows. Media. Animation namespace, each of which animates a different kind of value. 

Before some properties can be animated, they must be given a base value. For example, before 
animating the RectangleWidth of a Rectangle, the Rectangle must be set to a non-animated value (in this 
case, a Length object). 

In the following example, the Width of a Button is animated. Because the Width property takes a Length, 
a LengthAnimation is needed. A LengthAnimationCollection is used to contain the LengthAnimation. After 
the animation is created, it is applied to the button's Width property using the SetAnimations method. 
When using the SetAnimations property, you pass it the static property identifier field (in this example 
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Button.WidthProperty) for the class and the AnimationCollection containing the animations. The code 
used to set the button's size and position has been omitted. 

//C# 

Button aButton = new Button(); 
// Animate the Button's Width. 

LengthAnimation myLengthAnimation = new LengthAnimation(); 
myLengthAnimation.To = new Length(50); 
myLengthAnimation. Duration = new Time(5000); 
myLengthAnimation.AutoReverse = true; 
myLengthAnimation. RepeatDuration = Time.lndefinite; 
LengthAnimationCollection collection = new LengthAnimationCollection(); 
collection.Add(myLengthAnimation); 

// Set the animation. 

aButton. SetAnimations(Button.WidthProperty, collection); 
•VB.NET 

Dim aButton As MSAvalon. Windows. Controls.Button 
aButton = new MSAvalon.Windows.Controls.Button 

MSAvalon.Windows.Controls.Canvas.SetLeft(aButton, new MSAvalon. Windows. Length(20)) 
MSAvalon.Windows.Controls.Canvas.SetTop(aButton, new MSAvalon. Windows. Length(20)) 
aButton.Width = new MSAvalon.Windows.Length(200) 
aButton. Height = new MSA valon. Windows, Length(30) 
aButton.Content = "A Button" 

' Animate the Button's Width. 

Dim myLengthAnimation As MSAvalon.Windows.Media. Animation. LengthAnimation 
myLengthAnimation = new MSAvalon.Windows.Media. Animation. LengthAnimation 
myLengthAnimation.To = new MSAvalon.Windows.Length(50) 
myLengthAnimation. Duration = new MSAvalon.Windows.Media.Animation.Time(5000) 
myLengthAnimation.AutoReverse = true 
myLengthAnimation. RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time.lndefinite 
Dim collection As MSAvalon.Windows.Media.Animation.LengthAnimationCollection 
collection = new MSAvalon.Windows.Media. Animation. LengthAnimationCollection 
collection.Add(myLengthAnimation) 

aButton.SetAnimations(MSAvalon.Windows.Controls.Button.WidthProperty, _ 
collection) 

In the previous example, the starting value of the animation isn't specified, so the animation uses the 
value of the button's Width as its starting value. 

In the next example, the Background color of a second button is animated. The Background property 
takes a Brush. In this example, a SolidColorBrush is used to fill the button's Background, although a 
gradient, image, or pattern could have been used. To animate the button's background color, the Color of 
the SolidColorBrush must be animated. Because the SolidColorBrush. Color property accepts a Color, a 
ColorAnimationCollection and a ColorAnimation are used to animate the property. The Color property has 
a corresponding ColorAnimations property, so the ColorAnimation is added to the ColorAnimations 
property's ColorAnimationCollection using the Add method. 

//C# 

//Create and set the second Button. 
Button anotherButton = new Button(); 
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// Create and animate a Brush to set the Button's 
// background. 

SolidColorBrush myBrush = new SolidColorBrush(); 
my Brush. Color = Colors. Blue; 

ColorAnimation myColorAnimation = new ColorAnimation(); 
myColorAnimation.From = Colors. Blue; 
myColorAnimation. To = Colors.Red; 
myColorAnimation. Duration = new Time(7000); 
myColorAnimation.AutoReverse = true; 
myColorAnimation. RepeatDuration = Time.lndefinite; 

myBrush.ColorAnimations.Add(myColorAnimation); 
anotherButton. Background = myBrush; 



'VB.NET 
• Create and set the second Button. 
Dim anotherButton As MSAvalon.Windows.Controls.Button 
anotherButton = new MSAvalon.Windows.Controls.Button 
Canvas.SetLeft(anotherButton, new MSAvalon.Windows.Length(20)) 
Canvas.SetTop(anotherButton, new MSAvalon. Windows. Length(70)) 
anotherButton. Width = new MSAvalon, Windows. Length(200) 
anotherButton.Height= new MSAvalon. Windows. Length(30) 
anotherButton.Content = "Another Button" 

' Create and animate a Brush to set the Button's fill. 
Dim myBrush As MSAvalon.Windows.Media.SolidColorBrush 
myBrush = new MSAvalon.Windows.Media.SolidColorBrush 
myBrush. Color = MSAvalon.Windows.Media. Colors. Blue 
Dim myColorAnimation As MSAvalon.Windows.Media.Animation.ColorAnimation 
myColorAnimation = new MSAvalon.Windows.Media.Animation.ColorAnimatlon 
myColorAnimation.From = MSAvalon.Windows.Media. Colors. Blue 
myColorAnimatlon.To = MSAvalon.Windows.Media.Colors.Red 
myColorAnimation. Duration = new MSAvalon. Windows.Media.Animation.Time(7000) 
myColorAnimation.AutoReverse = true 
myColorAnimation.RepeatDuration = _ 
MSAvalon.Windows.Media.Animation.Time. Indefinite 
myBrush,ColorAnimations.Add(myColorAnimation) 
anotherButton. Background = myBrush 



VectorKeyFrameCollection Class 



Method 



Description 



Add 

CloneCore 



Strongly typed implementation of Add. 
Implementation of CloneCore. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Returns a modifiable copy of the cun^ent object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Creates a new VectorKeyFrameCollection 



CloneDownToUnchangeable 



Copy 



Copy 
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Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a reference 
to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

TODO 



EmbeddedChangeableWriter 
Equals 



Finalize 

GetCurrentSegmentValues 
GetHashCode 



GetType 

MakeUnchangeable 

MakeUnchangeableCore 
MembenviseClone 

ModifyHandlerifChangeable 
OnChanged 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

ToString 
Validate 

ValidateObjectState 
VectorKeyFrameCollection 

WritePostscript 
WritePreamble 



Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the cunrent instance. Inherited from Object. 

Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

Makes a Changeable object immutable. Inherited from Changeable. 

Creates a shallow copy of the current Object. Inherited from Object. 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false— this 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Shares a Changed event handler with the current objects data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from 
Object. 

Implementation of ValidateObjectState. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Pr party Description 

AllowChanqeableReferenceOverride ^^^^ ^^^^ ChangeableUsageOverride type sent in 

y as a parameter to ChangeableHelper.UseChangeable, to help 



564 



CanMakeUnchangeable 

Count 
Destination 

IsChangeable 

Item 



StatusOfNextUse 



UlContext 



determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Implementation of Count 

The value specified in the last KeyFrame. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object Is used in a 
DrawingContext command. Inherited from Changeable. 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 



VectorModifier Class 



CloneDownToUnchangeable 
Copy 

Copy 



Method Description 

Returns a modifiable shallow or deep clone of the current object. This 
CloneCore abstract method must be implemented by classes that derive from 

Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this VectorModifier 

Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 

Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 

Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
GetHashCode hashing algorithms and data structures like a hash table. Inherited from 

Object. 

Gets the Type of the current instance. Inherited from Object. 



EmbeddedChangeableWriter 
Equals 

Finalize 



GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 



Inherited from Modifier. 
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MakeUnchangeable 

MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 



OnChanged 

opjmplicit 

PropagateEventHandler 

ReadPreamble 

ReferenceEquals 

SetDefaultParentTimeline 

ToString 

ValidateObjectState 

VectorModifier 
WritePostscript 

WritePreamble 



Makes an object immutable; after this method is called on a 
Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 

Creates a shallow copy of the current Object. Inherited from Object 

Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable — if its IsChangeable property is false — ^thls 
method has no effect. Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a VectorModifier 

Shares a Changed event handler with the current object's data 
members or removes it. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are accessed. Inherited from Changeable. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 
Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are set. Inherited from Changeable. 



Property Description 

Used in conjunction with the ChangeableUsageOverride type sent in 

AllowChangeableReferenceOverride f Parameter to ChangeaWeHelper.UseChangeable. to help 

determine when a Changeable being put into use should be 
promoted to "ChangeableReference". Inherited from Changeable. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. Inherited 
from Modifier. 

Gets a value that indicates whether the animation is active or in a fill 
period. Inherited from Modifier. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 



CanMakeUnchangeable 

IsChangeable 

IsChanging 



IsOverridingBaseValue 
StatusOfNextUse 
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complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 

UlContext U {Context of the current object. The UlContext is used for 

maintaining thread safety. Inherited from Changeable. 
UsesBaseValue UsesBaseValue Inherited from Modifier. 



VectorTlmedModifler Class 



Method 



Beginin 



CloneCore 

CloneDownToU nchangeable 
Copy 

Copy 

Copy 
Disable 



Description 

Starts or restarts the animation at the specified offset from the cun^ent 
time. 

Returns a modifiable shallow or deep clone of the current object. This 
abstract method must be implemented by classes that derive from 
Changeable. Inherited from Changeable. 

Returns an immutable copy of the specified object. Inherited from 
Changeable. 

Creates a copy of this VectorModifier Inherited from VectorModifier. 
Returns a modifiable copy of the current object. The copy's 
IsChangeable property is true and its StatusOfNextUse is 
Unchangeable. Inherited from Changeable. 
Creates a copy of this VectorTimedModifier 

Disables this timeline, after which the timeline can no longer become 
active. The timeline can be re-enabled with a call to Enable. 



Accesses the specified Changeable data member, processes it, and 
returns a reference to the member. This reference should then be 
EmbeddedChangeableReader reassigned to the original member variable. Classes that derive from 

Changeable call this method on data members before they can be 
retrieved through property calls. Inherited from Changeable. 
Processes a modified Changeable data member and returns a 
reference to the processed object. Inherited from Changeable. 
Enables this timeline, parenting it to the timeline specified by the 
Enable ParentTimeline property. This allows the timeline to become active. This 

method throws an exception if the ParentTimeline property Is null. 
Endin Schedules an interactive end time. 



EmbeddedChangeableWriter 



Equals 
FilllnClone 

Finalize 

GetHashCode 

GetType 

GetValue 

GetValuelmpI 

IModifier.GetValue 

MakeUnchangeable 



Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perfomn other cleanup 
operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use In 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 
Inherited from VectorModifier. 
Inherited from VectorModifier. 
Inherited from Modifier. 

Makes an object immutable; after this method is called on a 



567 



MakeUnchangeableCore 
MemberwiseClone 

ModifyHandlerlfChangeable 

OnChanged 

opjmplicit 
Pause 

PropagateEventHandler 
ReadPreamble 

ReferenceEquals 

Resume 

Seek 

SetDefaultParentTimeline 
ToString 

ValidateObjectState 

VectorTimedModifier 
WritePostscript 

WritePreamble 



Changeable, its IsChangeable property is false. Inherited from 
Changeable. 

MakeUnchangeableCore Inherited from Modifier. 
Creates a shallow copy of the current Object. Inherited from Object. 
Adds or removes a Changed event handler to or from the specified 
Changeable object, if the object is currently modifiable. If the specified 
object is not modifiable— if its IsChangeable property is false— this 
method has no effect Inherited from Changeable. 

Called when the current object is modified. Classes that derive from 
Changed should call this method after they have been 
modified. Inherited from Changeable. 

Implicitly creates an AnimationCollection from a VectorModifier Inherited 
from VectorModifier. 

Pauses this timeline. 

Ensures that simple (non-Changeable) members are being accessed 
from a valid user interface (Ul) context. This method should be called 
before any simple members are accessed. Inherited from Changeable. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Resumes this timeline. 

Moves the current position of the animation backwards or fonvards from 
either the current time, the Begin time, or the End time. 

SetDefaultParentTimeline Inherited from Modifier. 

Returns a String that represents the current Object. Inherited from 

Object. 

Verifies that the current object has a valid state. If the object is in an 
invalid state, this method throws an exception. Inherited from 
Changeable. 

Causes the current object to validate itself and then invokes the 
OnChanged method. Inherited from Changeable. 
Ensures that simple (non-Changeable) members are being accessed 
from a valid Ul context. This method should be called before any simple 
members are set. Inherited from Changeable. 



Property Description 

Acceleration fraction of the simple duration spent in the 

acceleration phase. 

Used in conjunction with the ChangeableUsageOverride type sent in 
AllowChangeableReferenceOverride ^ Parameter to ChangeableHelper.UseChangeable, to help 

determine when a Changeable being put into "use" should be 
promoted to "ChangeableReference". Inherited from Changeable. 

AutoReverse ® ^^^^ indicates whether the animation plays in 

reverse after it completes its fonvard iteration. 

Begin Gets or sets an offset to the start time of the animation. 

True if this Changeable can be made unchangeable. Inherited from 
Changeable. 



CanMakeUnchangeable 



CurrentRepeat 



Gets the number of the current iteration of the animation. 
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CurrentTime 
Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChangeable 

IsChanging 
IsEnabled 

IsForward Progressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 
ParentTimeline 
Progress 
RepeatCount 

RepeatDuration 

Restart 

RestartDefault 
Speed 

StatusOfNextUse 

Timeline 
UlContext 



Gets the current time value of the animation. 

Gets or sets a value that represents the fraction of the simple 
duration spent in the deceleration phase. 

Gets or sets the length of time the animation takes to complete a 
single fonward iteration, also known as the simple duration of an 
animation. 

Gets or sets the maximum end time of the animation. 
Gets or sets a TimeEndSync enumeration that specifies how the 
implicit duration of an animation is determined. This property is only 
used if the Duration property is not explicitly set. 

Gets or sets a value that specifies the state of an object when its 
animation ends. 

Gets or sets a value that indicates the default value of the Fill 
property of the cunrent animation and its child timelines. 

Gets a Boolean that indicates whether the object is currently 
modifiable. Inherited from Changeable. 

Gets a value that indicates whether the animation is active. 

Gets a value that indicates whether the animation is progressing 
from past to future. 

Gets a value that indicates whether the animation is active or in a fill 
period. 

Gets a value that indicates whether the animation is active and 
paused. 

Gets a value that indicates whether the animation is currently 
moving in the opposite direction of its parent timeline. 
Gets or sets the default parent timeline of the animation. 

Gets a number from 0 to 1 that indicates the fraction of the simple 
duration that has elapsed. 

Gets or sets the number of times an animation should repeat. 
Gets or sets the total length of time the animation should play. If this 
value is greater than the simple duration of the animation, it will 
repeat itself for the length of time specified by this property. 
Gets or sets the animation's behavior when it is told to restart— that 
is, how the animation behaves when a second begin time is 
reached. 

Gets or sets the default value of the Restart property of the cun*ent 
animation and its child timelines. 

Gets or sets the relative speed at which time should pass for the 
animation, compared to its parent timeline. 

Gets or sets a UseStatus enumeration that specifies how the 
Changeable object behaves when it is "used." A Changeable object 
is considered used in the following situations: the object is set into a 
Property System property, the object is used as a sub-object in a 
complex Changeable object, or the object is used in a 
DrawingContext command. Inherited from Changeable. 
Timeline 

Gets the UlContext of the current object. The UlContext is used for 
maintaining thread safety. Inherited from Changeable. 
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UsesBaseValue 



UsesBaseValue Inherited from Modifier. 



INTERFACES 

ICIock Interface 

Definition: Represents an object that can provide linear time values. 

Property Description 

CurrentTime Gets the current time in milliseconds. 



The ICIock interface must be implemented by any objects that wish to act as the clock driving the timing 
engine. This interface contains a single property that the time manager calls periodically to obtain the 
current time. 



IModifier Interface 

Definition: Defines the basic behavior of a modifier object. A modifier is an object that takes an object, 
called the base value, of a certain type and returns another object of the same type as its output. 

Method Description 

Calculates the modifier's current value from the passed base value and the 
GetValue internal state of the modifier. If the modifier's UsesBaseValue property is set 

to false, the modifier Ignores the passed base value and calculates the 
cun^ent value from the internal state of the modifier. 

Sets the default parent Timeline of the modifier and its referenced timelines. 

SetDefaultParentTimeline 



Property Description 

IsChanqina '^^^ method returns a Boolean indicating whether the modifier could be changing 

^ ^ its value. 

IsOverriding Base Value Gets a Boolean that indicates whether the modifier is overriding its base value. 

UsesBaseValue Returns a Boolean that indicates whether the modifier uses an external base 
value to calculate the result of the GetValue method. 



ITImingControl Interface 

Definition: Defines the behavior of timelines and timed objects. 

Method Description 

Beginin Starts or restarts the timeline at the specified offset from the current time. 

Disable timeline, after which the timeline can no longer become active. The timeline can 

be re-enabled with a call to Enable. 

Enables this timeline, parenting it to the timeline specified by the ParentTimeline property. This 
Enable allows the timeline to become active. This method throws an exception if the ParentTimeline 
property is null. 

Endin Ends the timeline at the specified offset from the current time. 
Pause Pauses the timeline and all its child timelines. 
Resume Unpauses the timeline and all its child timelines. 
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Moves the current position of a timeline backwards or forwards from either the current time, 
Seek the Begin time, or the End time. 



Property 

Acceleration 

AutoReverse 
Begin 

CurrentRepeat 
CunrentTime 

Deceleration 

Duration 
End 

EndSync 
Fill 

FillDefault 

IsChanging 
IsEnabled 

IsForwardProgressing 

IsOverridingBaseValue 

IsPaused 

IsReversed 

ParentTimeline 

Progress 

RepeatCount 

RepeatDuration 

Restart 

RestartDefault 

Speed 



Description 

Gets or sets the fraction of the simple duration spent in the acceleration phase. 

Gets or sets a value that indicates whether the timeline plays in reverse after it 
completes its forward iteration. 

Gets or sets an offset to the start time of the timeline. 

Gets the number of the current iteration of the timeline. 

Gets the current time value of the timeline. 

Gets or sets a value that represents the fraction of the simple duration spent in 
the deceleration phase. 

Gets or sets the length of time a timeline takes to complete a single forward 
iteration, also known as the simple duration of an timeline. 

Gets or sets the maximum end time of the timeline. 

Gets or sets a TimeEndSync enumeration that specifies how the implicit duration 
of a timeline is determined. This property is only used if the Duration property is 
not explicitly set. 

Gets or sets a value that specifies the state of an object when its timeline ends. 

Gets or sets a value that indicates the default value of the Fill property of the 
current timeline and its child timelines. 

Gets a value that indicates whether the timeline is active. 

Gets a value that indicates whether the timeline is part of a timing sub-tree. 

Gets a value that indicates whether the timeline is progressing from past to future. 

Gets a value that indicates whether the timeline is active or in a fill period. 

Gets a value that indicates whether the timeline is active and paused. 

Gets a value that indicates whether the timeline is currently moving in the 
opposite direction of its parent timeline. 

Gets or sets the default parent timeline of the current timeline. 

Gets a number from 0 to 1 that indicates the fraction of the simple duration that 
has elapsed. 

Gets or sets the number of times a timeline should repeat. 

Gets or sets the total length of time a timeline should play. If this value is greater 
than the simple duration of the timeline, it will repeat itself for the length of time 
specified by this property. 

Gets or sets the timeline's behavior when it is told to restart— that is, how the 
timeline behaves when a second begin time is reached. 

Gets or sets the default value of the Restart property of the current timeline and 
its children. 

Gets or sets the relative speed at which time should pass for this timeline, 
compared to its parent timeline. 



ITimlngControlBuilder Interface 

Definition: Represents an object that can build a timeline template. 

Pr perty Descripti n 

Acceleration Accesses the Acceleration SMIL attribute. 
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AutoReverse 


Accesses 


Begin 


Accesses 


Deceleration 


Accesses 


Duration 


Accesses 


End 


Accesses 


EndSync 


Accesses 


Fill 


Accesses 


FillDefault 


Accesses 


ParentTimeline 


Accesses 


RepeatCount 


Accesses 


RepeatDuration 


Accesses 


Restart 


Accesses 


RestartDefault 


Accesses 


Speed 


Accesses 



the AutoReverse SMIL attribute. 

the Begin SMIL attribute. 

the Deceleration SMIL attribute. 

the Duration SMIL attribute. 

the End SMIL attribute. 

the EndSync SMIL attribute. 

the Fill SMIL attribute. 

the FillDefault SMIL attribute. 

the ParentTimeline attribute. 

the RepeatCount SMIL attribute. 

the RepeatDuration SMIL attribute. 

the Restart SMIL attribute. 

the RestartDefault SMIL attribute. 

the Speed SMIL attribute. 



MSAvalon.Windows.Media.TextFormatting 



The following tables list the members exposed by the MSAvalon.Windows.Media.TextFomiatting namespace. 



Classes 

InllneObjectlnfo 

TextFomnatter 

TextHighlightBounds 
Textlnfo 

TextLlne 

TextMarkerGeneratedContent 
TextMarkerinfo 

TextParagraphProperties 

TextRun 

TextRunBounds 
TextRunCache 
TextRunClientData 
TextRunProperties 

TextRunTypographyProperties 
TextSource 

TextTrimminglnfo 

Enumerations 

TextParagraphFlags 
TextRunCacheFlags 
TextRunType 



Provides measurement details for inline text objects. The formatting 
client passes this object as a parameter to the GetlnlineObjectlnfo 
method. 

TextFomnatter is the "Avalon" text engine and provides services for 
fomiatting text and breaking text lines. TextFomnatter can handle 
different text character formats and paragraph styles, and includes 
support for international text layout. 

Bounds of text range 

Represents information about a block of text in the client's text source 
character store. 

Provides services to a line of text. Inherit from this class to implement 
services that manipulate and fomnat a line of text. This is an abstract 
class. 

Generates line list marker output. 

Defines the style and type of a paragraph's list marker. The formatting 
client uses this class as a parameter to provide marker details to the 
GetTextMarkerlnfo method. 

Represents properties that can change from one paragraph to the next, 
such as flow direction, alignment, or indentation. 

Defines a sequence of characters that share a single property set. The 
formatting client provides TextRun details into this class when the 
TextFomnatter passes it as a parameter to the GetTextRun method. 
Bounds of text run 

Provides caching services to the TextFomnatter object in order to 
improve performance. 

Represents client information data associated with a TextRun. 
Provides properties that can change from one TextRun to another, 
such as typeface or foreground brush. This is an abstract class. 
Provides typography properties for TextRun. This client set of 
properties generates a set of features that are processed by the 
OpenType layout engine. 

Provides character data and fomnatting properties to the 
TextFomnatter. All access to the text in the TextSource is achieved 
through the GetTextRun method, which is designed to allow the client 
to virtualize text in any way it chooses. This is an abstract class. 
Provides description of text trimming characteristics. The formatting 
client fills trimming details into this class when the TextFormatter 
passes it as a parameter of the GetTextTrimminglnfo method. 

Flags describing paragraph characteristics 
Kind of content in text run cache 
Indicates the type of TextRun. 



Structures 

TextSourceCharacterlndex 



TextSourceCharacterlndex represents a caret or character position in 
text. 
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MSAvalon.Windows.Media.TextFormatting 

CLASSES 

InlineObjectInf Class 

Definition: Provides measurement details for inline text objects. The formatting client passes this object 
as a parameter to the GetlnlineObjectlnfo method. 

Method Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup operations 
before the Object is reclaimed by garbage collection. Inherited from Object. 
Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same instance. Inherited 
from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 

ReferenceEquals 
ToString 



TextFormatter Class 

Definition: TextFormatter is the "Avalon" text engine and provides services for formatting text and 
breaking text lines. TextFormatter can handle different text character formats and paragraph styles, and 
includes support for international text layout. 



Method 

Create 

Dispose 

Equals 

Finalize 

FormatLine 

GetHashCode 

GetType 

MemberwiseClone 

ReferenceEquals 

TextFormatter 
ToString 



Description 

Gets the TextFormatter object of the current running thread. 

Disposes of obsolete TextFormatter internal resources. 

Determines whether two Object instances are equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup 

operations before the Object is reclaimed by garbage collection. Inherited from 

Object. 

Creates a TextLine that is used to format and display a document. 
Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the cunrent instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Initializes a new instance of TextFormatter. 

Returns a String that represents the cunrent Object. Inherited from Object. 



Unlike a traditional text application programming interface (API), the TextFormatter interacts with a text 
layout client through a set of callback methods. It requires the client to provide these methods in an 
implementation of the TextSource class. 
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TextHighlightB unds Class 
Definition: Bounds of text range 



Method 

Equals 
Finalize 

GetHashCode 

GetTextRunBounds 

GetType 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Get array of rectangles each corresponding to rectangle bounds of each run 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object Inherited from Object. 



Property 

FlowDirection 
Rectangle 



Description 

Text flow direction inside the boundary rectangle 
Bounds rectangle 



Text Info Class 

Definition: Represents infomnation about a block of text in the client's text source character store. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 



ReferenceEquals 
SetCharacterBuffer 

ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object 
Creates a shallow copy of the current Object Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object 

Sets the Textlnfo character buffer. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Description 



CharacterOffset ^^^^ character offset relative to the beginning of the characterBuffer array to the first 
character of the TextRun. 



Length 



Gets or sets a value that represents the number of characters in the TextSource 
character store. 
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TextLine Class 

Definition: Provides services to a line of text. Inherit from this class to implement services that manipulate 
and fomiat a line of text. This is an abstract class. 



Method 

Dispose 
Equals 

Finalize 

GetDistanceFromTextSourceCharacterlndex 

GetHashCode 

GetSubLineCollection 

GetTextHighlightBounds 

GetTextRunClientDataCollection 

GetTextSourceCharacterlndexFromDistance 
GetType 

MembenvlseClone 

ReferenceEquals 
TextLine 

ToString 



Descriptt n 

Disposes of an obsolete instance of TextLine. 

Determines whether two Object instances are 
equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform 
other cleanup operations before the Object is reclaimed by 
garbage collection. Inherited from Object. 

Gets the distance from the beginning of a line of text from 
the specified textSourceCharacterlndex. 
Serves as a hash function for a particular type, suitable for 
use in hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets a collection of glyph runs that constitute the current 
line. 

Client to get an array of bounding rectangles of a range of 
characters within a text line. 

Gets a collection of client-specific objects associated with 
each TextRun in the line. 

Gets the TextSource character index that corresponds to 
the specified distance from the beginning of the line. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Determines whether the specified Object instances are the 
same instance. Inherited from Object. 

Initializes a new instance of TextLine. 

Returns a String that represents the current 
Object. Inherited from Object. 



Property 

Baseline 

DependantCharacterLength 

EmergencyWrapped 

Extent 
Height 
Length 

MarkerBaseline 

MarkerHeight 
MinWidth 

OverhangAfter 



Description 

Gets the distance from the top to the baseline of the cunrent TextLine. 
Gets the number of characters that follow the last character of the line. 
This information may cause the current line to be reformatted. 
Client to get a boolean value indicates whether the text line is 
emergency wrapped at the location nearest to the margin due to lack 
of valid linebreak opportunity in the line. 

Gets the distance from the topmost to bottommost black pixel in a line. 
Gets the height of a line of text. 

Gets the total number of TextSource positions of the current line. 

Gets the distance from the edge of the line's highest point to the 
baseline marker of the line. 

Gets the height of a list item's marker. 

Gets the minimum width possible for a given line. 

Gets the distance that black pixels extend beyond the bottom 
alignment edge of a line. 
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OverhangLeading 

OverhangTrailing 

Start 

TrailingWhitespaceLength 
Width 



Gets the distance that black pixels extend prior to the left leading 
alignnnent edge of the line. 

Gets the distance that black pixels extend following the right trailing 
alignment edge of the line. 

Gets the distance from the start of a paragraph to the starting point of 
a line. 

Gets the number of whitespace code points beyond the last non-blank 
character in a line. 

Gets the width of a line of text without trailing whitespaces. 



WidthlncludingTrailingWhitespace Gets the width of a line of text, including trailing whitespaces. 



TextMarkerGeneratedContent Class 

Definition: Generates line list marker output. 



Method Description 

Determines whether two Object instances are equal. Inherited from 
Object. 

Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

TextMarkerGeneratedContent Initializes a new instance of TextMarkerGeneratedContent. 

Returns a String that represents the cun^ent Object. Inherited from 
ToString Object. 



Equals 



Finalize 



GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 



Property Description 

Properties Gets or sets run properties of the TextMarkerGeneratedContent. 

UnicodeString Gets or sets a Unicode string used for accessibility. 



TextMarkerlnfo Class 

Definition: Defines the style and type of a paragraph's list marker. The fomnatting client uses this class as 
a parameter to provide marker details to the GetTextMarkerlnfo method. 



Method Description 

Equals Determines whether two Object instances are equal. Inherited from Object. 

Allows an Object to attempt to free resources and perform other cleanup 
Finalize operations before the Object is reclaimed by garbage collection. Inherited from 

Object. 

GetHashCode Serves as a hash function for a particular type, suitable for use in hashing 

algorithms and data structures like a hash table. Inherited from Object. 
GetType Gets the Type of the current instance. Inherited from Object. 
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Creates a shallow copy of the current Object. Inherited from Object. 

Detemiines whether the specified Object instances are the same 
Instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 

Property Description 

AutoNumberinglndex Gets or sets an index number for a counter-style list marker. 

Offset Gets or sets the distance from the text to the end of a list marker. 

RunProperties Gets or sets text properties used to render the list marker. 

Type Gets or sets the style of a text paragraph's list marker. 



MembenA/iseClone 
ReferenceEquals 

ToString 



TextParagraphProperties Class 

Definition: Represents properties that can change from one paragraph to the next, such as flow direction, 
alignment, or indentation. 



Method 

Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 
TextParagraphProperties 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perfomn other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited 
from Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Initializes a new instance of TextParagraphProperties. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

DefaultlncrementalTab 

DefaultTextRunProperties 

Flags 

FlowDirection 

HorizontalAlignment 
Hyphenator 
indent 
LineHeight 

TextWrap 



Description 

Gets or sets the default incremental tab distance. 
Gets or sets the default TextRunProperties. 

Gets or sets the Flags that describe characteristics of the paragraph of text. 

This property specifies whether the primary text advance direction shall be lefl- 
to-right, right-to-left, or top-to-bottom. 

This property describes how inline content of a block is aligned. 
Gets or sets access to the Hyphenation service provider interface. 
Gets or sets the amount of line indentation. 
Gets or sets the height of a line of text. 

Gets or sets the means by which text wraps when it reaches the edge of Its 
containing box. 
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TextRun Class 

Definition: Defines a sequence of characters that share a single property set. The formatting client 
provides TextRun details into this class when the TextFomriatter passes it as a parameter to the 
GetTextRun method. 



Method 

Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 
SetCharacterBuffer 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the cun-ent Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Sets the buffer type of the TextRun. 

Returns a String that represents the current Object. Inherited from Object. 



Property 



Description 



CharacterOffset character offset relative to the beginning of the TextRun array to the first 

character of the run. 

ClientData Gets or sets the TextFormatter object that the client then assigns to the TextRun. 

Length Gets or sets the number of TextSource character indices that the TextRun occupies. 

Properties properties that can change from one TextRun to the next, such as 

typeface or foreground brush. 

Type Gets or sets the type of TextRun. 

TextRunBounds Class 

Definition: Bounds of text run 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MembenviseClone 

ReferenceEquals 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 



Property 

CharacterLength 
Rectangle 



Description 

character length of bounded text run 
Text run bounding rectangle 
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TextSourceCharacterlndex 
Type 



First text source character index of text run 
type of the run 



TextRunCache Class 

Definition: Provides caching services to the TextFormatter object in order to improve performance. 



Method 

Change 
Equals 

Finalize 

GetHashCode 
GetType 

InvalidateCharacterBufferReferences 

MemberwiseClone 

ReferenceEquals 

TextRunCache 

ToString 



Description 

Notifies the client of a change in the cache when text or 
properties of the TextRun are added, removed or replaced. 

Determines whether two Object instances are equal. Inherited 
from Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Serves as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash 
table. Inherited from Object. 

Gets the Type of the current instance. Inherited from Object. 
Notifies the client of possible changes In the character buffer or 
character offset of the TextRun due to changes occuring in other 
parts of the text store. 

Creates a shallow copy of the current Object. Inherited from 
Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Initializes a new instance of TextRunCache. 

Returns a String that represents the current Object. Inherited 
from Object. 



Applications that use this caching mechanism are responsible for invalidating the content in the cache 
when it has changed. 



TextRunCllentData Class 

Definition: Represents client information data associated with a TextRun. 



Method 

Equals 

Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 

ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Returns a String that represents the current Object. Inherited from Object. 
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Pr perty Descripti n 

ClientData Gets or sets client-specific data associated with a TextRun. 

Length Gets or sets the character length of a TextRun. 

Type Gets or sets the type of the TextRun. 



TextRunProperties Class 

Definition: Provides properties that can change from one TextRun to another, such as typeface or 
foreground brush. This is an abstract class. 



Method 

Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 
TextRunProperties 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 
Determines whether the specified Object instances are the same 
Instance. Inherited from Object. 

Initializes a new instance of TextRunProperties. 

Returns a String that represents the cunrent Object. Inherited from Object. 



Property 

FontHintingEmSize 

FontRenderingEmSize 
ForegroundBrush 
HighlightBackgroundBrush 
LocalelD 

TextDecorationBrush 
TextDecoration Pen 
TextDecorations 
Typeface 

TypographyProperties 
VerticalBoxAlignment 



Description 

Gets or sets the text size in points, which is then used for purposes of font 
hinting. 

Gets or sets the text size in points. 

Gets or sets the foreground brush of the TextRun. 

Gets or sets the brush for the highlight background of the TextRun. 

Gets the locale ID of the TextRun. 

Gets or sets the Brush used for text decoration. 

Gets or sets the Pen used for text decoration. 

Gets or sets the TextDecorations used for the TextRun. 

Gets or sets the typeface of the TextRun. 

Gets or sets the typography properties of the TextRun. 

Gets or sets the vertical box alignment of the TextRun. 



The client provides a concrete Implementation of this abstract class. This enables the client to implement 
run properties in a way that fits with their fomnatting store. 



TextRunTypographyProperties Class 

Definition: Provides typography properties for TextRun. This client set of properties generates a set of 
features that are processed by the OpenType layout engine. 

Meth d Description 

^qu^'s Determines whether two Object instances are equal. Inherited from 
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Finalize 

GetHashCode 
GetType 

MemberwiseClone 
OnPropertiesChanged 

ReferenceEquals 

TextRunTypographyProperties 

ToString 



Object. 

Allows an Object to attempt to free resources and perform other 
cleanup operations before the Object is reclaimed by garbage 
collection. Inherited from Object. 

Sen/es as a hash function for a particular type, suitable for use in 
hashing algorithms and data structures like a hash table. Inherited from 
Object. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the current Object. Inherited from Object. 

Should be called every time any property changes it's value 

Detemiines whether the specified Object Instances are the same 
instance. Inherited from Object. 

Initializes a new instance of TextRunTypographyProperties. 

Returns a String that represents the current Object. Inherited from 
Object. 



Property 

AnnotationAltemates 

Capitals 
CapitalSpacing 

ContextualAltemates 

ContextualLigatures 
ContextualSwashes 



Description 

Gets or sets a value that specifies whether alternate notation forms are enabled. 
These forms include glyphs placed in open or solid circles, squares, parentheses, 
diamonds or rounded boxes. 

Gets or sets a value that indicates the capital form of the selected font. Capital 
forms include Normal, SmallCaps, AllSmallCaps, PetiteCaps, AllPetiteCaps, 
Unicase and Titling. 

Gets or sets a value that indicates whether inter-glyph spacing for all-capital text 
is globally adjusted to improve readability. 

Gets or sets a value that indicates whether custom glyph forms can be used 
based upon the context of the text being rendered. This is valuable for languages 
that have letters with multiple medial fomns that are used depending on the 
context of the surrounding letters. 

Gets or sets a value that indicates whether contextual ligatures are supported. 
Gets a value that indicates contextual swashes are enabled. Contextual swashes 
are typographic forms that are only applied based on the context of the text being 
rendered. 

Gets or sets a value that indicates whether discretionary ligatures are enabled. 
DiscretionaryLigatures Discretionary ligatures are typographic forms that font designers may add to their 
fonts to assist with readability. 

EastAsianExpertForms ^ indicates whether standard Japanese font forms have 

been replaced with the corresponding preferred typographic form. 

Gets or sets a value that specifies the version of glyphs to be used for a specific 
writing system or language. 

Gets or sets a value that indicates the proportional width to be used for Latin 
characters In an East Asian font. 

Gets or sets a value that indicates whether special fractional glyph forms are 
available. 

Gets or sets a value that indicates whether historical font forms are available. 
Historical forms are typographic conventions that were common in the past such 
as the long form of "s" or the Fraktur "k". 

Gets or sets a value that indicates whether historical ligatures are enabled. 
Historical ligatures are typographic fomis used in historical typography that font 
designers may add to their fonts. 



EastAsianLanguage 



EastAsianWidths 



Fraction 



HistoricalForms 



HistoricalLigatures 
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JustificationAltemates 
Kerning 

MathematicalGreek 

NumeralAlignment 
NumeralStyle 

SlashedZero 

StandardLigatures 

StandardSwashes 
StylisticAltemates 

StylisticSetl 

StylisticSetIO 

StylisticSetl 1 

StylisticSet12 

StylisticSetl 3 

StylisticSet14 

StylisticSetl 5 
StylisticSet16 



Gets or sets a value that indicates whether alternate glyphs of varying widths may 
be substituted to justify text. 

Gets or sets a value that indicates whether kerning is enabled. Kerning is a 
typographic function that adjusts the spacing between characters to enhance 
word shape. 

Gets or sets a value that indicates whether standard typographic font forms of 
Greek glyphs have been replaced with corresponding fontfomns commonly used 
in mathematical notation. 

Gets or sets the glyph set to be used for different numeric alignment scenarios. 
Gets or sets a value that selects a set of glyphs that are used to render numeric 
alternate font fomns that better match with their associated text. 

Gets or sets a value that indicates whether a nominal zero font form should be 
replaced with a slashed zero. 

Gets or sets a value that indicates whether standard ligatures are enabled. 
Standard ligatures assist with readability. 

Gets or sets a value that indicates if standard swashes are enabled. Standard 
swashes are typographic fomns that font designers may add to their fonts that 
have common usage. 

Gets or sets a value that indicates whether stylistic alternates are enabled. 
Stylistic alternates are glyph designs for a purely aesthetic effect that don't fit into 
a category such as historical or swash. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to hamrionize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
Some fonts contain stylistic variant glyphs that correspond to portions of a 
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character set Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSet17 Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSet18 Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSet19 Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSetZ Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSet20 Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSetS Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSet4 Some fonts contain stylistic variant glyphs that con-espond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 
StylisticSetS Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually. 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 

StylisticSetS Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 

StylisticSet? Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to hamrionize visually, 
interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 

StylisticSetS Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 

interact in particular ways, or work together in other ways. 

Gets or sets a value that indicates whether a stylistic set of a font form is enabled. 

StylisticSetS Some fonts contain stylistic variant glyphs that correspond to portions of a 

character set. Glyphs in stylistic sets may be designed to harmonize visually, 
interact in particular ways, or work together in other ways. 

Variants ^ ^^^^ indicates a variation of the standard typographic form 

should be used. Variants are similar to superscript or subscript font forms. It is 
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possible for a font form to have glyph sets that differ between superscript and 
ordinal forms, or between subscript and inferior forms. 



TextSource Class 

Definition: Provides character data and formatting properties to the TextFormatter. All access to the text in 
the TextSource is achieved through the GetTextRun method, which is designed to allow the client to 
virtualize text in any way it chooses. This is an abstract class. 



Method 

Equals 
Finalize 

QetHashCode 

GetlnlineObjectlnfo 

GetPrecedingText 
GetText 

GetTextMarkerlnfo 
GetTextRun 

GetTextTrimminglnfo 
GetType 

MemberwiseClone 

ReferenceEquals 

TextSource 
ToString 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by garbage collection. Inherited from 
Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 

TextFormatter to get metrics of inline object started at specified text source 
character index 

Instructs the TextFormatter to get the text immediately before the specified 
TextSource position. 

Instructs the TextFormatter to get the text at a specified TextSource position. 

TextFormatter to get marker information of text paragraph 

Instructs TextFonnatter to get a TextRun starting at a specified TextSource 
position. 

TextFormatter to get text trimming characteristics when text overflows the 
margin. 

Gets the Type of the current instance. Inherited from Object. 

Creates a shallow copy of the cunrent Object. Inherited from Object 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 

Initializes a new instance of TextSource. 

Returns a String that represents the current Object. Inherited from Object. 



TextTrimminglnfo Class 

Definition: Provides description of text trimming characteristics. The fomiatting client fills trimming details 
into this class when the TextFomriatter passes it as a parameter of the GetTextTrimminglnfo method. 



Method 

Equals 
Finalize 

GetHashCode 
GetType 

MemberwiseClone 
ReferenceEquals 



Description 

Determines whether two Object instances are equal. Inherited from Object. 
Allows an Object to attempt to free resources and perform other cleanup 
operations before the Object is reclaimed by gari3age collection. Inherited from 

Object. 

Serves as a hash function for a particular type, suitable for use in hashing 
algorithms and data structures like a hash table. Inherited from Object. 
Gets the Type of the current instance. Inherited from Object. 
Creates a shallow copy of the current Object. Inherited from Object. 

Determines whether the specified Object instances are the same 
instance. Inherited from Object. 
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ToString Returns a String that represents the current Object Inherited from Object. 

P"" Perty Description 

EllipsisBackgroundBrush Gets or sets the background brush of a trimming ellipsis symbol. 

EllipsisForegroundBrush Gets or sets the foreground brush of a trimming ellipsis symbol. 

Type Gets or sets the style of trimming. 
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